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Preface 


PURPOSE 


AUDIENCE 


CONTENTS 


This publication is designed to serve as an aid for the 
person(s) responsible for designing files on the IBM 
Displaywriter System. It includes general files concepts 
and a detailed description of files and the text 
documents used with files. This publication is not 
intended for use as a general training manual. There is a 
list of related training material under the heading 
"Related Publications . " 


This publication is intended for the office personnel 
responsible for designing files on the IBM Displaywriter 
System. You do not need to know how to operate the IBM 
Displaywriter System to use this publication. However, 
if you will be operating the IBM Displaywriter System as 
well as designing the files, you may want to complete the 
operator training prior to using this publication. 

Previous knowledge of text processing or files use is 
helpful, but not mandatory, to use this manual. You must, 
however, be familiar with the intended files applications 
and workflow in your organization. 


This manual contains fourteen chapters and three 
appendixes : 

• "chapter 1. Introduction" contains an overview of 
this publication. 

• "Chapter 2. What is A File?" introduces general files 
concepts and defines the characteristics of IBM 
Displaywriter System files. 

• "chapter 3. Designing a File" contains information 
about analysis of current information handling, an 
alternate file type, and potential design problems. 

• "Chapter 4. Creating a File" contains information 
about the possible sources of IBM Displaywriter 
files. These sources include typing the file. 
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converting it from text, and having it communicated 
from a computer. 

"chapter 5. File Output" explains the options for 
printing a file or storing the completed output on 
diskette. It also explains the options for printing 
unformatted file output and merging a file with text 
to produce letters, reports, and lists. 

"chapter 6. Selecting Records" explains how certain 
records can be chosen from the file for use. 

"Chapter 7. Sorting Records" explains how records can 
be placed in either alphabetical or numeric order 
during output . 

"Chapter 8. Math Instructions" contains information 
about using math calculations in reports and letters. 

"Chapter 9. Storing Math Formats and File Setups" 
explains how numbers from the file and from math 
calculations can be formatted so that they print 
differently depending on the format used. Stored 
setups for storing the selection criteria and sort 
fields are also explained. 

"chapter 10. Repetitive Letters" contains detailed 
information about merging files with a shell document 
to produce personalized form letters. 

"Chapter 11. Reports" contains detailed information 
about merging several records with a shell document 
to produce a summary report with grouped information. 

"Chapter 12. Reports That Look Like Letters" explains 
how a personalized form letter can be created that 
uses information from more than one record. 

"Chapter 13. File Lists" explains how multi-column 
file lists are created. 

"Chapter 14. Evaluating and Correcting File Problems" 
contains tips on identifying and correcting problems 
in faulty file design. 

"Appendix A. Worksheets" contains blank worksheets 
that can be copied and used for files design. 

"Appendix B. Character Sort Chart" contains a sort 
chart that shows the character order that the system 
uses when it sorts records. 
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"Appendix C. Converting Text Into Records" contains 
the rules and considerations for converting a text 
document into a file. 


RELATED PUBLICATIONS 


The other available publications in the IBM Displaywriter 
System Library include: 

• General Information Manual for the IBM Displaywriter 
System ^ (G544-0851). This manual provides an 
introduction to the IBM Displaywriter System. It 
contains a description of the Displaywriter System 
components, the functions performed by the various 
Displaywriter System licensed programs, and examples 
of some text and record applications. 

• Customer Planning Guide for the IBM Displaywriter 
System , (S544-0852). This manual provides the 
information the customer needs to prepare for the 
arrival and setup of the system. The manual 
discusses such topics as the size and weight of 
system components, the required system operating 
environment, and space requirements. 

• IBM Displaywriter System Customer Setup Guide , 
(S544-0858). This guide gives detailed step-by-step 
instructions for system setup. With this guide, 
customer personnel can, without training or tools, 
unpack system components, arrange them in a work 
area, connect power cords and intermachine cables, 
prepare units for operation, and run the system 
verifier test. This guide is shipped with the 
system. 

• IBM Displaywriter System Operator Training Book 1 — 
Basic Topics Textpack 4 , (S544-2034) . This manual is 
the beginning instruction book for the IBM 
Displaywriter System. It should be completed by all 
operators . Qnce operators complete their training 
with this book, they should be able to perform basic 
tasks on an IBM Displaywriter System. 

• IBM Displaywriter System Operator Training Book 2 — 
Selectable Topics Textpack 4 , (S544-2035). This 
manual is the second instruction book for the IBM 
Displaywriter System. It is to be used after the 
operator has completed Book 1 — Basic Topics . This 
manual contains information about topics that not all 
operators need. Operators should complete only those 
topics relevant to their work. 
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IBM Displaywriter System Operator Training — 
Reportpack , (S544-2030). This manual is the 
instruction book for using the Reportpack feature on 
the IBM Displaywriter System. This manual contains 
information about topics that not all operators need. 
An operator should complete only those topics 
relevant to his or her work. A prerequisite for 
starting this book is completion of the IBM 
Displaywriter System Operator Training Book 1 — 
Basic Topics Textpack 4 . 

IBM Displaywriter System Problem Determination Guide , 
(S544-0860). This manual, a part of the IBM 
Displaywriter System Reference Package Materials, 
list problems that may occur during the operation of 
the system. It also describes the procedures that an 
operator can follow to determine both the cause of 
the problem and the solution. 

IBM Displaywriter System Work Station Procedures 
Guides — Textpack 4 , (S544-2037) . This manual, a 
part of the IBM Displaywriter System 
Training/Reference Materials from Textpack 4, is 
designed to be a bridge between the Operator Training 
Books and the customer's own work. The "Procedure 
Guide" section includes guidelines and suggestions 
for setting up procedures for program and work 
diskette handling and printer sharing. The "Work 
Samples Handbook" section contains work samples with 
step-by-step instructions for processing a document. 

IBM Displaywriter System Work Station Procedures 
Guide — Reportpack , (S544-2033) . This manual is 
designed to be a bridge between the Operator Training 
Books and the customer's own file applications. The 
"Procedures Guide" section contains guidelines and 
suggestions for setting up procedures for program and 
work diskette handling. The "Work Samples Handbook" 
section contains work samples with step-by-step 
instructions for processing file related documents. 

IBM Displaywriter System Operator Reference Guide — 
Textpack 4/Reportpack (S544-2032) . This manual is the 
basic reference book for the IBM Displaywriter 
System's functions, parameters, and possible options. 
It is a detailed guide to the system. It includes 
system information, menus, and a quick reference 
section. 

IBM Displaywriter System Prompts And Messages Guide 
— Textpack 4/Reportpack , (S544-2021). This manual 
lists the prompts and messages that appear on the 
display to guide and inform an operator. The listing 
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indicates when a prompt or message occurs and actions 
an operator can take when a response is needed. 

IBM Displaywriter System Office Systems Support 
Center Guide , (S544-0874) . This manual contains a 
description of the services offered, procedures to 
follow, and information about what to expect when 
calling the IBM Office Systems Support Center. 
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Introduction 


Using the Worksheets 


Almost every organization needs stored files of 
information that are complete, easily accessed, and 
usable in a variety of ways. These files include 
personnel files, inventories, lists of customers and 
suppliers, telephone directories, and other types of 
information. The file information is used daily to 
develop a variety of administrative lists, directories, 
schedules, project and program reports, and letters. 

The IBM Displaywriter System is designed to help you 
handle your files management needs, as well as your text 
processing needs. The IBM Displaywriter System functions 
are provided by licensed programs which are contained on 
diskettes. The IBM Displaywriter System Textpack 4 
Licensed Program supports your text processing 
applications, such as creating and revising documents. 
The IBM Displaywriter System Reportpack Licensed Program 
supports the creation, storage, and revision of files. 
Text created on the Displaywriter can be merged with the 
files to produce form letters, lists, and reports. 

With the IBM Displaywriter System, an operator may create 
a file of client information and use that file to generate 
a list of client names and addresses, send personalized 
letters to selected clients on the list, and prepare a 
report that summarizes client information. 


HOW TO USE THIS GUIDE 


Successful use of a file depends on the proper design of 
the file. Before you can decide what information should 
be in a file and in what form, you must determine what the 
final output documents from the file will be, and you must 
be aware of the IBM Displaywriter System's capabilities. 
This guide is designed to give you all the information you 
need to design and use a file successfully. In some parts 
of this guide, you may find more information than you need 
for your application. In that case, simply look through 
the additional information so that you are aware it is 
there. 


This guide contains several worksheets that serve as a 
tool as you design and use your file. These worksheets 
have three purposes: 
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1. You can use the worksheets to collect and organize 
the information necessary to create the file and then 
create the desired output documents from the file. 
The worksheets have been designed to help you 
understand what information is necessary for various 
tasks . 

2. By keeping the worksheets after you've filled them 
out, you have a written record of the decisions that 
you made about your file. This can be particularly 
valuable if you want to review your design later or if 
someone else needs to fill in for you. The worksheets 
are the only written information about your file 
design that you'll have. 

3. In addition, if you are not the Displaywriter 
operator, you can use the worksheets to transmit 
information about the file to the operator. Since 
the same worksheets are shown in the operator 
training material, the Displaywriter operator should 
be familiar with them and understand how to implement 
the information from the worksheets on the 
Displaywriter . 

As each worksheet is introduced, you will be told how to 
complete it. In addition, almost all the examples in this 
guide are taken from the same personnel file. Many 
examples show a completed worksheet along with the final 
document . 

Appendix A contains blank copies of each worksheet that 
you can copy and use later for your own work. 


Using the Chapter Exercises 


Much of the information that you will be learning is 
interrelated. The design of your file depends, in part, 
on how your file is used and what types of output you 
want. Because of this, you should read the entire guide 
before you begin designing your own file. 

Review exercises and answers are provided at the end of 
most chapters. These exercises are designed to give you 
practice in using the skills that you learned in that 
chapter. Complete the review exercises, then compare 
your answers to the answers given. Although in some cases 
there can be more than one correct answer, be sure that 
you understand why the correct answer is correct. 

To make the exercises more realistic, the same file will 
be used in all the chapter exercises. It is a sales files 
that might be kept in a company employing several sales 
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representatives and it tracks customer information and 
sales amounts . 


Other Helpful Information 


The following features are designed to help you as you use 
this guide for the first time: 

• Important terms are printed in bold type the first 
time they appear. The terms are defined in context, 
and definitions of these and other terms are included 
in the Glossary. 

The Glossary also contains an explanation of the 
symbols and word processing abbreviations that are 
used in this guide. If you see a symbol in an example 
that you do not understand, look in the Glossary. The 
symbols are listed at the beginning of the Glossary 
before the other entries. 

• Chapter summaries at the end of most chapters briefly 
list the highlights of that chapter. These summaries 
assume that you have read the chapter. They do not 
include the detailed background material found in the 
chapter. 

• Some pages do not contain a full page of text. Don't 
worry — this was done to make it easier for you to 
see two page figures or a figure and explanatory text 
at the same time. 


Introduction 1-3 


This page intentionally left blank. 


1-4 


What Is A File? 


This chapter contains information about: 

• general file definitions 

• file uses 

• file output 

• Displaywriter files, records, and fields 

• file revisions 


GENERAL FILE DEFINITIONS 


GENERAL FILE USES 


A file is a collection of related information. For 
example, a personnel file' may consist of the information 
found in personnel folders. 

A record is a collection of related words or data that 
make up one entry in a file. For example, a record can 
contain all the information about one person, one 
project, or one department. 

A field is one piece of information in a record; for 
example, the first name of a person. A record is made up 
of fields. 

Figure 2-1 showns how files, records, and fields are 
related. 

Each heading in Figure 2-1 (e.g.. First Name) names a 
file field, so in this example there are 21 fields in each 
record. In this example, each record requires more than 
one line to print. 


Simply having the information stored is not enough. To 
make the information usable, you may need to do some 
manipulation of the information, such as: 

• Select certain records for use. For example, you 
would want to include all employees* names and 
telephone numbers in a telephone directory, but a 
report listing the names of employees eligible for 
retirement should not include the names of all your 
employees . 
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2 Mrs. Loma 
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Ronald Crawford 
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K."* Rogers 345 West $th Street 
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A. Boyle 122 North 10th Street 
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Sort records into alphabetical or numerical order. 
For example, you might want all names in an employee 
file to be in order by personnel number or an 
alphabetized telephone directory. 

Do math calculations on some of the fields in the 
file and print the results of the calculation. For 
example, if you are doing a sales report, you may want 
to show the individual sales items and also show the 
total of the sales, the average sale amount, and 
other pertinent information that makes the report 
more meaningful. 

Print only certain fields in a record. You need to be 
able to extract information not only from a file, but 
also from a record. The information required depends 
on the application or use of the information. To 
print a name on a mailing list, you would use the 
first name, middle initial, and last name. To print 
the salutation on a letter, you would probably use 
only the last name with a title, such as Mr. Jones. 


GENERAL FILE OUTPUT 


For a file to be useful, you have to be able to use the 
information in the file in some type of file output. File 
output usually involves printing some portion of the file 
with the information formatted in a specific way, such as 
a name and address list, or inserted into some 
accompanying text. Generally, there are four different 
types of printed output: 

1. repetitive letters 

2. reports 

3. multi-column file lists 


forms 


Repetitive Letters 


The repetitive letter is a document that has constant text 
(the text that is the same in every letter) typed in a 
shell document. A shell document is a text document that 
is like a form letter, but the shell document uses special 
codes that tell the system the names of the fields or 
variables to be merged into the shell document during 
output or printing. 

The shell document is merged with the appropriate file to 
produce personalized letters that have the contents of 
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the named field (s) from each record inserted into the 
shell document at the points marked by the special codes. 
One letter is produced for each record in the file, unless 
you select only certain records to be merged with the 
shell document. Figure 2-2 shows some sample letters 
produced by merging a shell document with a file. 
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To: ; Brian Rogers ] 

i Administration Department ] 

From: Dan P. Andrews 

Date: December 15, 1981 


I am pleased to announce that, effective January 1, 1982, Greg Randolph, 
General Plant Manager, has been promoted to headquarters. He will be 
serving as an Assistant to the Board of Directors. 

I am also pleased to announce that Peter Robertson, from the Detroit 
office, will be replacing Mr. Randolph. He hopes to visit our location 
soon and he will be chatting informally with many of you. 

If you have any questions, please contact your manager , [Roger JCramer^ 

Again, please join me in congratulating Mr. Randolph and welcoming Mr. 
Robertson. 


Dan P. Andrews 
President 


To: Lorna Boyle 

; Engineering DepartraentJ 

From: Dan P. Andrews 

Date: December 15, 1981 


I am pleased to announce that, effective January 1, 1982, Greg Randolph, 
General Plant Manager, has been promoted to headquarters. He will be 
serving as an Assistant to the Board of Directors. 

I am also pleased to announce that Peter Robertson, from the Detroit 
office, will be replacing Mr. Randolph. He hopes to visit our location 
soon and he will be chatting informally with many of you. 

If you have any questions, please contact your manager, '.Ronald Cra^^ 

Again, please join me in congratulating Mr. Randolph and welcoming Mr. 
Robertson. 


Dan P. Andrews 
President 


Figure 2-2. Sample repetitive letters 
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Reports 


A report is also created by merging a shell document with 
a file, but the final document combines information from 
more than one record. The purpose of a report is to 
present the file information in the most easily- 
understood, meaningful way.- To do this, you can group, 
format, and summarize the information, and even include 
math calculations. Figure 2-3 shows some sample reports 
generated from the file. 
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This report is designed to give the reader an understanding of the 
relationship of department, sex, and salary in two departments: 
Accounting and Administration. Managers' salaries are not included. 


EEC Report: Sex and Salary 


Accounting 


Name Salary 


Marilyn L. Velasco $16,783.00 
Carol A. Fisher $20,387.00 
Helen K. Morgan $22,839.00 


Average Department Salary: $20,003.00 


Accounting 


Name Salary 


Roger T. Norton $18,378.00 
George J. Steiniger $20,298.00 
David Y. Clark $22,918.00 
Walter M. Smith $24,893.00 
Maxwell A. Madison $25,298.00 


Aver£ 

r,^ noriOT-t-monh q-ilQT-,r. <^99 TS7 DO 


Admir 

To answer the many questions we've received, we've prepared the 
following report which gives a summary of salaries. This list is 
divided by sex. 



Managers' salaries are not included. 


Aver£ 

EEC Report: Salary and Sex 


Admii 

F 

Average Salary: $19,099.32 
Highest Salary: $29,082.00 
Lowest Salary: $10,500.00 




M 


Averi 

Average Salary: $21,964.83 
Highest Salary: $32,938.00 
Lowest Salary: $12,938.00 


Overc 

Average Company Salary: $20,472.38 
Highest Company Salary: $32,938.00 
Lowest Company Salary: $10,500.00 




Figure 2-3. Sample file reports 
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Multi-column File Lists 


A multi-column fije list contains information from more 
than one record, formatted so that more than one column of 
information is printed. Because a list is simply a 
listing of information, the information cannot be 
summarized and math calculations cannot be used. 

Figure 2-4 shows two different types of lists that might 
be created from the same file. 
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Mr. Michael F. Acker 

Mrs. Carol A. Fisher 


8798 Main Street 

345 Balboa Drive 


White Rock, TX 72839 

Dallas, TX 71829 


Ms. Peggy L. Anderson 

Mr. Victor P. Fisher 


2839 Columbus Cove 

63583 Windy Trail Drive 


Dallas, TX 72839 

Dallas, TX 71829 


Miss Karen J. Benson 

Mrs. Rachel L. Forrest 


556 Singletree Street 

3847 Cheyenne Drive 


White Rock, TX 72639 

Irving, TX 73689 


Mrs. Theresa H. Black 

Mr. Ralph R. Garcia 


382 Round Circle 

28394 North Causeway 


Dallas, TX 71829 

Dallas, TX 71829 


Miss Dorothy P. Boswell 

Ms. Debbie S. Goodman 


908 Steck Avenue 

4848 Rome Way 


Dallas, 




Mrs. Loi 




122 Norl 
Dallas, 

Name 

Extension Name 

Extension 

Mr. Ricl 
3846 Sw( 

Acker, Michael F. 
Anderson, Peggy L. 

3849 Nelson, Patricia H 
4579 Norton, Roger T. 

5434 
2837 

Dallas, 

Benson, Karen J. 

4567 Ostrom, Gerald S. 

1726 


Black, Theresa H. 

8493 Ostrom, James R. 

3847 

Ms. Sue 

Boswell, Dorothy P. 

3728 Park, Trisha J. 

3948 

1054 Gr( 

Boyle, Lorna A. 

2736 Perkins, Sherry J. 

3553 

Dallas , 

Bradley, Richard J. 

2734 Perry, Tracy S. 

2839 


Burns, Sue R. 

2938 Preston, Diane K. 

3894 

Mr. Simi 

Carrigan, Simon E. 

3879 Rogers, Brian K. 

7462 

283 Oak 

Chapman, Lorna J. 

8293 Schultz, Lisa G. 

5839 

Dallas, 

Clark, David Y. 
Crawford, Ronald G. 

8293 Shaw, Pauline F. 
5736 Smith, Walter A. 

5840 
5938 

Ms. Lori 
384 Pini 

Davidson, Jean T. 
Fisher, Carol A. 

6483 Smith, Walter M. 3874 
5647 Steiniger, George J. 8379 

White Ri 

Fisher, Victor P. 
Forrest, Rachel L. 

7874 Swanson, Simon E. 
4958 Tweeden, Nancy W. 

5849 
8293 

Mr. Dav: 

Garcia, Ralph R. 

3684 Velasco, Marilyn L 

4958 

10345 J( 

Goodman, Debbie S. 

6789 Velasco, Michael L 

2748 

T)a ^ ^ a-^ 

Hunt, Allen K. 

8394 White, Barbara N. 

5394 

uaj-A-CXO , 

Jackson, Thomas W. 

2837 White, Jack E. 

3868 

Mr. Ron; 
345 Muc;l 

Kahn, Cecelia B. 

2838 Wilson, Barbara J. 

2647 

Kelly, Laverne W. 

2839 Wilson, Frank P. 

1839 

■J'-r ^ llUo 

White R( 

Knight, Roger H. 

9087 Young, Gloria F. 

3847 


Kramer, Roger P. 

2273 


Ms. Jeai 

Lambert, Stanley R. 

5483 


5930 Wo( 

Lee, Cynthia R. 

2837 


Irving, 

Lopez, Robert M. 

3782 


Madison, Maxwell A. 

3956 



Martin, Jeff D. 

3856 



Morgan, Helen K. 

2583 



Nelson, Mavis Y. 

8293 




Figure 2-4. Sample telephone list and name and address list 
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Forms 


Designing forms requires that information be formatted in 
a specific way, but in files usage a form is either a 
report (if it requires information from more than one 
record) or a repetitive letter (if it requires one form 
per record) . 


IBM DISPLAYWRITER SYSTEM FILES 


Now that you understand the general concepts about files, 
you need to know the specific requirements for an IBM 
Displaywriter file. 

An IBM Displaywriter file, like the file shown in Figure 
2-1, consists of records. Each record consists of 
fields. Each IBM Displaywriter file, such as a personnel 
file or client file, must fit on one diskette. In 
addition, the entire file, including any new records that 
you will be adding, cannot exceed 65,000 records. The 
chart in Figure 2-5 shows various record lengths and 
approximately how many full records of various lengths 
can be placed on an IBM 1 and or on an IBM 2D diskette. 

The key factors that affect the record capacity of a 
diskette, other than the defined record length, are: 

• The number of fields. Additional fields will reduce 
capacity from those shown in the chart. 

• The number of bytes actually contained in the record. 
If each field is not filled to its limit, the capacity 
will increase from those shown in the chart. 

• The amount of unused diskette space. As a record is 
deleted it leaves unusable diskette space. The file 
must be condensed to make full utilization of that 
unused space. 

Note: Displaywriter storage is actually measured in 
bytes. A byte is generally equivalent to a character, so 
for convenience this guide uses the term "character." 
However, you should be aware that, although some symbols 
and instructions appear on the display as a single 
character, they require more than one byte of storage 
space. 
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Record Size 

Number of 
Fields 

IBM 1 

Diskette- 

IBM 2D 

Diskette" 

100 characters 

10 

fields 

207f 

> records 

7500 

records 

200 characters 

20 

fields 

HOC 

) records 

3950 

records 

300 characters 

30 

fields 

750 

records 

2700 

records 

400 characters 

40 

fields 

570 

records 

2050 

records 

500 characters 

50 

fields 

450 

records 

1650 

records 

600 characters 

60 

fields 

375 

records 

1375 

records 

700 characters 

70 

fields 

325 

records 

1190 

records 

800 characters 

80 

fields 

290 

records 

1040 

records 

900 characters 

90 

fields 

240 

records 

930 records 

1000 characters 

100 fields 

210 

records 

830 records 


" The number of records is approximate and represents 1 file per diskette 
Figure 2-5. Estimation of Record Lengths and Diskette Capacity 


IBM Displaywriter records are divided into one or more 
fields, each identified by a name that you assign. Record 
size is determined by two factors: 

1. number of fields (maximum 100 fields per record) 

2. number of characters (maximum 1,000 characters per 
record) 

When designing your file, you must consider both the 
number of fields and the total number of characters in a 
record. Neither maximum can be exceeded. 

IBM Displaywriter files contain named fields which are in 
the same order in each record and have the same 
characteristics. The fields in an IBM Displaywriter 
System record are defined by the following three 
characteristics . 


1. Field is any name that the operator assigns to a 

field. For example, in a name and address file, the 
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fields might be named "First Name", "Last Name", and 
so on. 

Field names have the following requirements: 

• Up to 16 characters in length 

• Can contain alphabetic characters, numbers, 
spaces, and the underscore character 

• First character in each field name must be an 
alphabetic character 

• Each field name in a file must be unique 

Field names are displayed while you are typing or 
selecting records. You also use field names to tell 
the system what field(s) to use when merging a 
document with a file and in what order to sort 
records . 

2. Field type refers to the various characters which can 
be typed in a field. The three possible field types 
are character, math, and text. See "Field Types and 
Maximum Lengths" below for a description of each 
field type. 

3. Maximum field length is the longest possible entry in 
a field. It is set by the operator and limited by the 
field type for that field. To determine the maximum 
field length for a field you can use one of two 
methods : 

• Choose the longest entry in a file and count the 
number of characters in that entry. 

• Decide upon some informal rule based on your 
experience with the file. In the examples and 
exercises in this guide, the general rule is 
first names (10 characters), last names (15), 
street addresses (25), and cities (15). 

See "Field Types and Maximum Lengths" for more 
information. 


Field Types and Maximum Lengths 


Before typing records into a file on the IBM 
Displaywriter, the operator must create a file 
description which contains a field description for each 
field in the file. A field description defines the field 
name, field type, and maximum field length for that 
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field. After the file description is completed, the 
operator can type the records . 

As the file information is typed into the fields, the IBM 
Displaywriter System compares the typed information to 
the field descriptions. The system allows the operator to 
type only characters that match the field type for a field 
and that do not exceed the maximum field length. If the 
operator tries to type the wrong type of characters in a 
field or to type more characters than permitted by the 
maximum field length for that field, the system will not 
accept the information and will alert the operator to the 
error. 


Character Field Type 


Alphabetic and numeric characters, punctuation, and 
spaces can be typed in a character field. (See Q in 
Figure 2-6.) No control characters, such as tabs or 
carrier returns, are allowed. (A control character is a 
non-printing, word proces'sing character used in 
formatting text.) 

You can select specific records or sort the records in 
alphabetic or numeric order based on the information in a 
character field. You can not do math calculations with 
the numbers in a character field. 


Maximum Field Length for Character Fields 


Math Field Type 


A character field has a maximum field length of 80 
characters . 


A math field can contain only numbers, a decimal point, 
and a plus or minus sign. (See Q in Figure 2-6.) The 
plus or minus sign and the decimal point are optional. 

Any field that contains only numbers (and a decimal point 
and/or a plus or minus sign) should be described as a math 
field. Designating the field as a math field allows the 
system to check the input so that only numbers are typed. 
In addition, a math fields is the only field type that can 
be used for math calculations. 

Remember, however, th^t certain numbers such as telephone 
numbers (394-3829, for example) and Social Security 
numbers (583-28-3849) have hyphens in them so they must 
be described as character fields, not math fields. 
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Rec ID Title First Name 
Extension Hire Yr 
comments 


MI 


Last Name 


Mr, 


Brian 


K. Rogers 


Department 


Administration 


1 ^__ 

7462 65 

Recent evaluations good. Shows management potential. Suggest he be 

given more in-house training. 


Figure 2-6. Sample Character, Math, and Text Fields 


You can select specific records or sort the records in 
numeric order based on the information in a math field. 
You can also perform math calculations using the contents 
of a math field. 


Maximum Field Length for Math Fields 


Text Field Type 


Math fields have a maximum field length of 17 characters 
which includes: 

• one character for a positive or negative sign 

• one character for a decimal point 

• 15 digits 

You do not type any characters that might precede or 
follow the number, such as a dollar sign, or any commas 
(thousands separators). These are automatically added 
later by a math format control when the file is used. 
(Math format controls are explained in more detail in 
Chapter 9 . ) 


A text field contains alphabetic and numeric characters, 
science and math symbols, and control characters, such as 
tabs and carrier returns. (See Q in Figure 2-6.) A text 
field is an informative or descriptive field that is only 
to be printed. 


2-14 


For example, you could use a text field to record 
open-ended comments that exceed 80 characters in length 
(the maximum for a character field) . You could also use a 
text field for information that contains science or math 
symbols, or format information. 

You cannot select specific records or sort records based 
on the information in a text field. 


Maximum Field Length for Text Fields 


A text field has a maximum field length of 500 characters. 
To save space within the file, a text field can contain 
one or more Include Instructions which, when the field is 
printed, will retrieve and print text typed in a regular 
text document. 

These Include Instructions contain: 

• the name of the document and the name of the diskette 
where the text is located 

• the page number (s) of the page(s) containing the text 

• some system control characters for the Include 
Instruction itself. 

Each Include Instruction uses an average of 30-50 
characters of file space. If the text that you want 
included with the file is longer than 50 characters, an 
Include Instruction may save file space. 

You may also want to use an Include Instruction if you 
have text that is used with more than one record. Rather 
than retype the text in each record, you may want to type 
it once as a text document. 


Revising Field Types and Maximum Lengths 


You also need to know the restrictions on revision of 
field types and maximum lengths. You can change a field 
description after the file is created. However, after 
the first record has been typed, you can change a field 
description in a file only as described below. 

1. The field type can be changed only to a field type 
that is less restrictive. 

• A math field, the most restrictive type since it 
can contain only numeric characters , can be 
changed to either a character field or a text 
field. 
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• A character field, which is less restrictive 
because it can contain either alphabetic 
characters or numeric characters , can be changed 
only into a text field. 

• A text field, because it can contain information 
such as control characters that cannot be used in 
the other field types, cannot be changed to a 
different field type. 

If there is any doubt about field type, use the more 
restrictive field description initially since it can 
be changed later if necessary. 

2. After a file is created, the maximum field length can 
be increased (up to the maximum field length 
permitted for that field type) . You can not decrease 
the size of the maximum field length after the first 
record has been typed. 

This restriction is designed to protect any records 
that you may have in the file. The system can not 
check file contents while you are revising the field 
descriptions. So, if you were allowed to shorten a 
maximum field length, you might invalidate some 
information already typed into the file. 

As your file description nears the maximum character 
size of 1,000 characters, be particularly careful 
about describing longer maximum field lengths than 
necessary. Be conservative and describe the maximum 
field length as the length of the longest entry in 
each field, remembering that if necessary you can 
increase the maximum field length. 

If you have to change the field type to a more restrictive 
field type or decrease a maximum field length, you must 
first create a new file with the desired file 
description, and then duplicate the records to the new 
file. You'll find more information on duplicating a file 
in Chapter 4 . 
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REVIEW QUESTIONS 


1. Using the file below, draw a box around a record. 
Circle a field within that record. 


Rec ID 

First Name 

MI 

Last Name 

Department 

Extension 

1 
2 
3 

4 

5 

Brian 

Lorna 

Sue 

Gerald 

Trisha 

K. 
A. 
R. 
S. 
J. 

Rogers 

Boyle 

Burns 

Ostrom 

Park 

Administration 

Engineering 

Administration 

Marketing 

Planning 

7462 
2736 
2938 
1726 
3948 


2. True/false. A repetitive letter uses the information 
from more than one record. 

3. True/ false. A report uses the information from more 
than one record. 

4. What is the maximum number of characters in a 
Displaywriter record? 

5 . What is the maximum number of fields in a 
Displaywriter record? 

6. What are the three field types? 


Which field type cannot be changed to another field 
type after a file has been created? 

Can you decrease the maximum field length after the 
file description is created and a record is typed? 
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REVIEW ANSWERS 


1. 


Rec ID First Name 


MI 


Last Name 


Department 


Extension 


1 
2 




Administration 


7462 



I'ldlkULXllg 

Planning 


2. False. Each repetitive letter uses the information 
from only one record. One letter is produced for each 
selected record in the file. 

3. True. A report uses the information from more than 
one record. A report compiles the information from 
all the selected records in a file into one final 
document . 

4. The maximum number of characters in a Displaywriter 
record is 1,000. 

5. The maximum number of fields in a Displaywriter 
record is 100 . 

6. The three field types are character, math, and text. 

7. A text field cannot be changed to another field type 
after a file has been created because it can contain 
control characters and symbols that are not allowed 
in either character or math fields . 

8. You cannot decrease the maximum field length after a 
record has been typed into a file, unless you 
duplicate the records into a file with a different 
field description. However, you can decrease the 
maximum field length after a field description has 
been created, if no records have been typed into the 
file. 
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CHAPTER SUMMARY 


A Displaywriter file must fit on one diskette. 

A Displaywriter record can contain: 

up to 100 fields 

— up to 1,000 characters 

Displaywriter fields are described in the following 
chart . 


Field 
Type 

Field 
Length 

Can Contain 

Can Be Used To 

Numbers 

Alphabetic 
Characters 

Symbols and 

Control 

Characters 

Sort 

Select 

Math 

1-17 

X 



X 

X 

Character 

1-80 

X 

X 


X 

X 

Text 

1-500 

X 

X 

X 




Figure 2-7. Field Characteristics by Field. Types 


Revisions of field descriptions can be made: 

— before a record has been typed, to a less 
restrictive field type: 

— a math field can be changed to a character 
field or text field 

— a character field can be changed to a text 
field 

— a text field cannot be changed to any other 
field type 

— after a record has been typed, through 
duplication to a file with different field 
descriptions but the same field names 

File output includes: 

- repetitive letters - one output document per 
record 

- reports and lists - one output document for the 
file 
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Designing A File 


This chapter contains information about: 

• analyzing current information management 

• potential design problems and recommendations for 
avoiding them 

• using an alternate type of file with complete and 
partial records 

• creating a sample file 


CURRENT INFORMATION MANAGEMENT 


Now that you know what an IBM Displaywriter file 
requires, you can begin your actual files design. The 
files design procedure begins with data collection. 
During this phase of files design you need to collect 
ideas to determine what information needs to be in the 
file. 

To do this , first look at the current means of tracking 
information in your office. Some of the questions you 
need to answer include: 

• What are the files that you want to store on the IBM 
Displaywriter? 

• Where do those files come from? For example, is the 
information now on forms, typed lists, or index 
cards? Where does the information originally come 
from? 

In your organization, you might find that when an 
employee fills out a personnel form, 1) the 
information is then entered into a computer file, 2) 
the form itself is stored in a folder, and 3) some 
information from that form, such as name and 
telephone numbers, might be kept in a rotary file or 
on a typed list. 

• What lists, reports, and letters are now being 
generated from the information in the proposed file? 
What other types of output would you like to be able 
to do? 

• Are there other things that you would like to be able 
to do with the information in the file, such as sort 
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the information into alphabetical or numerical order 
or perform mathematical calculations? 


What Files Are Kept Now? 


As a first step, determine whether files are now being 
kept in any of the common forms shown below. 

typewritten lists 

rotary files 

index card files (these might be stored in boxes, 

drawers, trays, tubs, or rotary files) 

printed forms 

ledgers 

microfiche 

microfilm 

metal name and address plates 

After you've checked these potential sources for files, 
talk to people who work in the area where a file is kept 
They may be able to supply additional information about 
how the file is maintained and used. 


What Are the Fields of Information? 


Once you identify the existing files, start defining the 
purposes of each file by completing the following three 
steps . 

1. List the fields of information stored in an existing 
file on a copy of the File Design Worksheet. For each 
field you need to list: 

• a Field Name (maximum of 16 characters) 

• a Field Type 

• the maximum field length (No. of Characters) for 
that field 

You also can use the optional Comments section for 
additional information about each field. If, for 
example, the names of states should be typed into the 
file as two-digit abbreviations, then make a note in 
the Comments sections for the field for state. 

Figure 3-1 shows how a File Design Worksheet was 
filled in for the sample personnel file. 

List everything that needs to be recorded and 
tracked. Decisions as to what information is 
important will be made later. 
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FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE- 


NUMBER OF 
CHARACTERS-' 


COMMENTS 


'TjL^t//^ 


c/^Jl 


± 


^o^AcJx^ .JOU/in/Xha^L^ 


^X AA i:/' :^ dniA-> 


/O 


>2UL 


.,^ricA u>^jCU//>'tc;^^^^ 


(^OyQlf ^/2yy)tJ^ 


/s 


^//MUl^ 


^ 


Q^TtujCt^ j/AtxiA^ 


.2^ 



/S 


2^ 


..^.4>OJL. 


Oc^^ki/iAJojlUait^ 


>)y Ctn/jL. 



rHi 


'OXX. 


S 


.JiA-cm s^ 


ci^JLL. 


fyyjj 




/O 


^MjQjf' .^rr^uyrtj^ (Tl^yCj^^^yoocif—' 



yrKO^^^ 


^ Seto^ 


^ 


A^ J^myyi_ 


;2- 


:>L^L3a£&^Ls(2L- 


cAah^ 


/6 


^//■^pflAy!A</XO^y 


2S- 


Mixd- 


a^Afio/-. 


yrtgyrytJL^ 



^£tjU 


1. 


yy//>nAi/DD 



•rr7* 


'jctA. 


A 


/tkQ. 


a^££i^2^^£^l&Lii^Z^^^khA4i^ 


Q^JL^ 


c/.^!Jly 


^ ^ /n 


^Sz^^W<k ^<ryo 


>yuviA^ 


^ 


7"Ah ji^ Ija.. 


:z. 


^ 


uh u "^mA iu/. 


"'character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 


Figure 3-1. Sample File Design Worksheet 
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Now look at the sample output documents that you've 
collected. Circle each piece of variable information 
on each sample document. (See Figure 3-2 for an 
example). If the sample document is a list or report, 
you may find that almost the entire output consists 
of variable information. 

Note on the sample document which fields of 
information the variables represent. These fields 
might include a customer's name, a contract 
expiration date, or the amount of a donation. Mark 
the variables that are the results of math 
calculations . 


Deciding What information to Use in Your File 


Now that you have a list of potential fields, evaluate 
which of these fields should be used in the Displaywriter 
File. Ask yourself these questions. 

• What fields in the list that I created on the File 
Design Worksheet are used in the output sample 
documents? 

If a field is used in the output samples, then it 
definitely needs to be a field in your file. 

• Is there information used in the output samples that 
is not listed on the File Design Worksheet and is not 
the result of math calculations? 

If there is, this may be a file field. Add these 
fields to your File Design Worksheet. 

• If some fields listed on the File Design Worksheet 
are not used in the output samples, how is the 
information from those fields used now? 

Decide why this information is included in the 
existing files. Consider the following possibilities. 

- There may be some output samples that you don't 
have. This can happen if there are letters or 
reports generated from the existing file that are 
not done often. 

- The information in a field, while not used in any 
output, is needed to calculate another variable. 
For example, an employee's date of birth may not 
be printed in a report, but it is used to 
determine age and eligibility for retirement. 
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This report is designed to give the reader an understanding of the 
relationship of deparnient, sex, and salary in two departments: 
Accounting and Administration. Managers' salaries are excluded. 


EEO Report: Sex and Salary 


Accounting 


Name 


Marilyn L. Velasco 
Carol A. Fisher 
Helen K. Morgan 
Roger T. Norton 
David Y. Clark 
George J. Steiniger 
Walter M. Smith 
Maxwell A. Madison 



Salary 

W, 783. 00 
$20,387.00 
$22,839.00 
$18,378.00 
$22,918.00 
$20,298.00 
$24,893.00 
$25,298.00 


Average Department Salary: ($21. 474^25)- OAJUji/l (^fTip /\._ 


Administration 


Name 


Salary 


Sue R. Burns 
Laverne W. Kelly 
Dorothy P. Boswell\ 
Tracy S. Perry 
Nancy W. Tweeden 
Brian K. Rogers 
Ralph R. Garcia 
Stanley R. Lambert, 


$10,500.00 
$11,892.00 
$12,827.00 
$11,456.00 
$14,284.00 
$13,495.00 
$14,893.00 
$18,394 


.uu 
^^00/ 

Average Department Salary: C^^*'^^^ '^\^Ca£cjU^!ajt£^v\^ 


Overall 


January 5, 1982 


/lc 


Lorna A. Boyle 
[ 122 North 10th Street 
V Dallas, TX 71283 


Dear/ Mrs. Boylej 


I am delighted to announce that our fifth annual company dinner will be held 
January 16, 1982 in the Executive Dining Room to celebrate a good year. I am 
hop ing tha t you'll be attending. Please allow me to extend an invitation to you 
and^Dav^l 

In addition to the dinner, there will be dancing afterwards. 

Please RSVP to your department secretary by January 10. 

Sincerely, 


Dan P. Andrews 
President 


Figure 3-2. Output Samples With Variables Identified 
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The information may not be used for anything. 
This can happen if information, although not used 
now, was useful at one time and so is still 
tracked and stored in the file. 

Before you conclude that the information is not 
useful, however, check with everyone who works 
with the file. It may be that it is used by 
someone with whom you did not previously talk. 
If there is any doubt, it is safer to include the 
information as a field in the Displaywriter file. 


AVOID SOME POSSIBLE PROBLEMS 


Names 


At this point, you have a list of the fields that will 
make up your file. Before you begin to create your file, 
however, you can avoid some potential problems by proper 
file design. 

Before designing your file, you need to examine five 
types of commonly used information: 

• names 

• addresses 

• dates 

• information (such as inventory numbers) that has both 
alphabetic and numeric characters 

• combined fields 

Before you decide how to use these items in your file, you 
need to consider the following: 


As you design your file, you may consider a person's full 
name (title, first name, middle initial, and last name) 
to be one field of information. However, you need to look 
at how the name will be used in output. The following 
considerations can affect how the name stored in the file 
can be used: 

1. When you merge your file with a shell document for a 
list, letter, or report, the system must print all 
the information in each field used in the shell 
document. Thus, if a person's full name is in one 
field, everything in the field (the full name) will 
be printed each time that field is used. 

If you are printing a name and ciddress list for a 
mailing, then having the person's full name print is 
desirable. But if you are sending that person a 
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Addresses 


letter, a salutation such as "Dear Mr. William A. 
Jones:" is awkward. 

To avoid this problem, you can create a separate 
field for each part of the name. In your file, each 
name would require three fields: first name, middle 
initial, and last name. Depending on your planned 
file use, you may also want to include a field for 
nicknames . 

2. Remember to include a title field (Mr., Mrs., etc.) in 
any file in which you have names. The system does not 
recognize gender and doesn't know what title belongs 
with a name. Unless you have a title field in your 
file, your only solution would be to use one title in 
the shell document with all names. But you might be 
embarrassed if you send a letter to Mr. Sally Brown, 
so it's better to include a title field. 

3. Also include a subtitle field for such subtitles as 
"Jr.", "ill", etc. If you put the subtitle in the 
last name field, such as "Brown, Jr.", then the name 
would print correctly on a mailing list as "Mr. 
George G. Brown, Jr.". But if you choose to use the 
last name field in the salutation, it will print as 
"Mr. Brown, Jr.:" — obviously awkward. 

Do not put the comma after the last name in either the 
last name or the subtitle field. You'll learn in 
Chapter 5 how to print the comma when there is an 
entry in the subtitle field, but not print it when the 
subtitle field is empty. 

If you are not sure what your output will require, use 
five fields for each name: title, first name, middle 
initial, last name, and subtitle. This arrangement will 
give you the maximum flexibility for using the name in 
output . 


As you design the file, you may consider putting an entire 
address, such as the one following this paragraph, in one 
field. However, putting the entire address in one field 
prevents you from selecting certain records or sorting 
them into a specific order. You might, for example, want 
to sort your file so that the letters print in zip code 
order. You can do this only if the zip code is in a field 
by itself. Or, if you want to select all the records for 
people living in Texas, the states must be in a separate 
field. 
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Printed Address 


Name and Address Fields 


Mr. John Q. Doe 

4736 South Main Street 

Austin, Texas 78764 


1 pr>l_ 2_lJohni _ 3_ N«L 

5 4736 South Main ""Street _ 

6 ktistin; 7 i Texas! 8 


Dates 


Printing A Date 


For maximum flexibility, you should use one field for the 
street or postal address, one field for the city, one 
field for the state, and one field for the zip code. 


The IBM Displaywriter recognizes only alphabetic 
characters or numbers, not dates. To include dates within 
your file, carefully consider how you will use the dates. 
Two primary considerations, printing dates and using 
dates to sort records, are discussed below. 


If you want the written date to print out in your final 
document (such as, "Your lease will expire on June 20, 
1982."), then the date must be typed in your file that 
way. However, if you attempt to sort the records, the 
system alphabetizes the records. When that happens, 
December 17, 1982 appears before October 17, 1982 because 
D comes before in the alphabet. 

So, to print a written date in your final documents, you 
need one field for the printing date (June 1, 1982) and 
another field that contains the date in numbers 
(82/06/01) which can be sorted correctly. There is, 
however, more than one way to design a numeric date field. 
The considerations involved are described in the next two 
sections . 


Sorting Date by Year, Month, and Day 


If you want to sort the records based on dates or to 
select the records that contain certain dates, you need 
to have the dates typed as numbers. But, the system 
recognizes these fields as numbers, not dates. The 
following paragraphs explain how the system sorts these 
numbers. (As a shortcut, refer to dates written in 
numbers as MM for month, DD for day, and YY for year.) 
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If you type a date as MM/DD/YY (such as 08/01/82 for 
August 1, 1982 and 08/13/78 for August 13, 1978), then the 
system reads the numbers as 080182 and 081378. These 
records are read and sorted in this order: 

080182 
081378 

When the records are sorted this way, August 1, 1982 is 
listed as occurring before August 13, 1978. (The slashes 
don't affect the sort order if you use them consistently 
throughout your file. You can also choose not to use 
slashes in your dates.) 

To avoid similar problems, you should use YY/MM/DD (or 
YYMMDD) in your date field and always use two digits for 
each part of the date. For example, January 5, 1982 would 
be 82/01/05. (You don't need to add the 19 on the year 
unless your file has dates in different centuries.) 


Sorting Dates by Month and Day 


Look again at your planned file use. Typing the dates as 
YY/MM/DD causes the records to sort first by year, then by 
month, then by day. In Figure 3-3, the employee records 
are in order by birth date. 
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Employ 

ee Records Sorted by Year, Month, and Day of 

Birth 

Year 

Month 

Day 

Name 


19 

05 

07 

Allen K. Hunt 


28 

04 

09 

Ronald G. Crawford 


30 

08 

12 

Richard J. Bradley 


32 

05 

07 

Victor P. Fisher 


32 

11 

25 

Dorothy P. Boswell 


34 

12 

25 

Peggy L. Anderson 


35 

09 

12 

Stanley R. Lambert 


36 

01 

05 

Michael L. Velasco 


37 

03 

12 

Barbara J. Wilson 


37 

07 

31 

Gerald S. Ostrom 


37 

08 

06 

Maxwell A. Madison 


38 

01 

15 

Michael F. Acker 


38 

03 

08 

Laverne W. Kelly 


38 

06 

15 

Roger P. Kramer 


38 

06 

30 

Sherry J. Perkins 


40 

03 

04 

Gloria F. Young 


40 

11 

30 

Jack E. White 


41 

05 

23 

Walter M. Smith 


41 

06 

11 

Theresa H. Black 


41 

08 

22 

Pauline F. Shaw 


41 

12 

07 

Helen K, Morgan 


41 

12 

24 

Brian K. Rogers 


42 

05 

07 

Roger H. Knight 


42 

12 

07 

Rachel L. Forrest 


42 

12 

18 

Patricia H. Nelson 


43 

03 

18 

Jean T. Davidson 


43 

03 

26 

Jeff D. Martin 


43 

03 

28 

David Y. Clark 


43 

09 

17 

Robert M. Lopez 


44 

06 

04 

Lisa G. Schultz 


44 

06 

05 

Simon E, Carrigan 


44 

07 

28 

Walter A. Smith 


45 

04 

22 

Ralph R. Garcia 



" "~ 

— " ' 


Figure 3-3. Sample List of Dates Sorted By Year, Month, and Day 


This arrangement may meet most of your requirements. 

However, you may want to print lists such as a monthly 
birthday list. In such a list, the records should be in 
order first by month, then by day, without regard to the 
year. To do this your file design must be slightly 
different from YY/MM/DD. 

You should separate your date into three fields: year, 
month, and day. You still type the year as YY, the month 
as MM, and the day as DD, but each part of the date is in a 
different field. 

You can sort or select the file in various ways. If you 
want to sort by year, month, and day you would use all 
three fields; but you can also create your birthday list 
by using only month and day as selection or sorting 
criteria. Figure 3-4 shows the same birthdate list as 
Figure 3-3, but this time the records are sorted by month 
and day only with the year shown in parentheses. 
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Employ 

JG Reco 

rds Sorted by Month and Day of Birth 

Month 

Day 

Year 

Name 

01 

05 

36 

Michael L. Velasco 

01 

15 

38 

Michael F. Acker 

01 

16 

55 

Mavis Y. Nelson 

02 

05 

50 

Roger T. Norton 

02 

15 

46 

Lorna J. Chapman 

03 

04 

40 

Gloria F. Young 

03 

08 

38 

Laverne W. Kelly 

03 

08 

47 

Nancy W. Tweeden 

03 

12 

37 

Barbara J. Wilson 

03 

18 

43 

Jean T. Davidson 

03 

26 

43 

Jeff D. Martin 

03 

26 

57 

Tracy S. Perry 

03 

28 

43 

David Y. Clark 

OA 

08 

51 

Lorna A. Boyle 

OA 

09 

28 

Ronald G. Crawford 

04 

11 

49 

Diane K. Preston 

04 

16 

50 

Cynthia R. Lee 

04 

22 

45 

Ralph R. Garcia 

05 

07 

42 

Roger H. Knight 

05 

07 

19 

Allen K. Hunt 

05 

07 

32 

Victor P. Fisher 

05 

23 

41 

Walter M. Smith 

05 

28 

48 

James R. Ostrom 

06 

04 

44 

Lisa G. Schultz 

06 

05 

44 

Simon E. Carrigan 

06 

11 

45 

Trisha J. Park 

06 

11 

41 

Theresa H. Black 

06 

12 

45 

Cecelia B. Kahn 

06 

15 

38 

Roger P. Kramer 

06 

24 

45 

Thomas W. Jackson 

06 

28 

50 

Frank P. Wilson 

06 

30 

38 

Sherry J. Perkins ^ . 


Figure 3-4. Sample List of Dates Sorted by Month and Day 


Using three fields for each date does require more 
fields, but it is more flexible than the YY/MM/DD design. 
Generally, if you are not sure about all the possible uses 
of your file, use one field for the written out date that 
is to be printed only, and one field each for the numeric 
date for the year, month, and day. If you define the 
numeric dates as math fields , you can perform math 
calculations involving the dates. 


Information With Both Alphabetic Characters and Numbers 


Occasionally, an inventory number, property description, 
or other items have both alphabetic characters and 
numbers. It is critical that you know how that 
information will be used. If it is to be used for 
printing only, then it can be contained in one field. 


Designing a File 3-11 


However, to sort or select the records based on that 
information, you need to determine how the records are 
sorted now. For example, a part number such as AD206 may- 
contain two pieces of information. The characters AD 
might refer to a machine type and 206 to the number of the 
part. The same part for another machine might be an 
ED206. In this example, you might want to create a list 
by part number (all 206s regardless of machine type) or of 
all parts for machine type AD. 

Such a field would have to be described as a character 
field because it contains alphabetic characters as well 
as numbers. Although you'll learn in more detail in 
Chapter 7 about how records are sorted, the basic sorting 
order is : 

• graphic characters (any non-alphabetic, non-numeric 
character such as a %, a &, or a space) first, 

• then alphabetic characters, 

• then numbers . 

Information is sorted from left to right, so the system 
compares the first (farthest left) character in the sort 
field in each record. If two or more records have the 
same character in that position, the system looks at the 
next character. If that character is also the same in two 
or more records, the system looks at the third character 
from the left, and so on until the records have been 
sorted into order. 

Notice how the file containing the following sample part 
numbers would be sorted, and you'll understand why the 
sorting order is important. The unsorted file is shown 
first. 




Unsorted 

File 

Amount 

Month 

Day 

Part Number 

150 

01 

12 

AD138 

500 

05 

11 

ED118 

1500 

12 

05 

LR268 

250 

06 

23 

SE238 

450 

11 

30 

AD126 

578 

11 

15 

AD322 
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If the system were sorting these part numbers to put them 
in order, they would appear as they do in the following 
sorted file. 


Combined Fields 




Sorted 

File 

Amount 

Month 

Day 

Part Number 

450 

11 

20 

AD126 

150 

01 

12 

AD138 

578 

11 

15 

ADS 2 2 

500 

05 

11 

ED118 

1500 

12 

05 

LR268 

250 

06 

23 

SE238 


The part numbers appear in this order because the system 
sorts them by comparing the entries in the Parts Number 
field from left to right. The first two characters are 
alphabetic and since alphabetic characters are placed in 
order before numbers, the part numbers are basically in 
alphabetical order based on the first two characters in 
the part number . 

Since the system looks at each entry from left to right, 
there is no way to print a list from this file that puts 
the part numbers into numeric order using the last three 
numbers . 

If such a sort is necessary, the part numbers must be 
split into two fields. The first field contains the 
alphabetic characters, and the second field contains the 
numeric characters . This arrangement provides the 
maximum flexibility for sorting and selecting records. 
(Even though you may have two fields for the part number, 
it can be printed so that it appears to be one item. ) 


If you need more than 100 fields of information, you can 
use a combined field for information that you want to 
track, but not print. In a combined field you use codes 
for information instead of spelling the information out. 
In this way, you can compress a number of fields into one 
field. 

For example, instead of designing one field for sex and 
one field for age, you might design one field and use a 
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code for sex (M=male, F=female) and a number for age. An 
entry for a female, age 24, would be F24; a male, age 31, 
would be entered as M31. 

Before you decide to use combined fields in your file, you 
need to consider carefully how the file is to be used. You 
can still select records using this method. However, 
your ability to sort the records is limited. In the 
previous example, the records with females would always 
appear before males because F sorts before M. With a 
combined field like that, it would not be possible to sort 
the records into order based on age. 

In addition, because you cannot print a part of a field, 
to print a list with names and ages you would have to 
print the entire field. Instead of printing "Jane Doe, 
24", the system would print "Jane Doe, F24". 


COMPLETE AND PARTIAL RECORDS 


You may want to design a file in which there are several 
records that contain much the same information. For 
example, a sales file might contain one record for each 
transaction. If one customer placed ten different 
orders, for example, there would be ten records for that 
customer. The customer's name, address, and sales 
representative name would be stored in each of the ten 
records. Figure 3-5 shows a sample of such a file. 


Rec ID 
Order 

Customer Name 
Date 

Address 

City 

_ 11 

Zip 

Order 

Sales Rep 

2 
02/18 

Universal Industries 

90 Elm Street 

Pomona 

CA 

77890 

60000 

Curtis 

3 
01/21 

Universal Industries 

90 Elm Street 

Pomona 

CA 

77890 

32000 

Curtis 

4 
04/14 

Universal Industries 

90 Elm Street 

Pomona 

CA 

77890 

89900 

Curtis 

5 
03/18 

Universal Industries 

90 Elm Street 

Pomona 

CA 

77890 

28000 

Curtis 


Figure 3-5. Records From a Sample Sales File 


If you have a file like this, you may want to create a 
file with complete and partial records to save file space 
and typing time. 

A complete record contains the information that is common 
to a group of records and that is normally retyped in each 
record. When you use a file with complete and partial 
records, this redundant information is typed only in the 
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complete record. In the sales file, the complete record 
Would contain the customer's name, address, and sales 
representative's name. 

The information, such as amount of order and the date the 
order was placed, is different in each record. This 
information is typed into separate, partial records. The 
information in the partial record is unique to that 
record, except for a key field. A key field is a field 
that exists in both complete and partial records and is 
used to link a group of records together. In the sales 
file shown in Figure 3-6 the name of the sales 
representative is used as the key field to link the 
complete and partial records together. 


Rec ID Customer Name 
Order Date 

Address 

City 

_ ST 

Zip 

Order 

Sales Rep 

1 Universal Industries 
01/21 

90 Elm Street 

Pomona 

CA 

77890 

32000 

Curtis 

2 
02/04 





130890 

Curtis 

3 
02/18 





60000 

Curtis 

4 
03/18 





28000 

Curtis 

5 
04/14 





89900 

Curtis 

6 
05/07 





200550 

Curtis 


Figure 3-6. Sample Sales File with Complete and Partial Records 


A file with complete and partial records can be used to 
produce repetitive letters, and some reports and lists. 
Figure 3-7 shows a report created from the file in 
Figure 3-6. (Information on creating this type of report 
is contained in Chapter 12.) 
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To: Universal Industries 


90 Elm Street 


Pomona, CA 77890 


Below is a 

list of all sales made to you between January and June, and 

the total amount due. 


Date of 

Order Amount 

of Order 

01/21 


$32,000.00 

02/04 


$130,890.00 

02/18 


$60,000.00 

03/18 


$28,000.00 

04/14 


$89,900.00 

05/07 


$200,550.00 

07/15 


$26,000.00 


Total: 

$567,340.00 

If you have 

any questions, please contact your sales 

representative. 


Figure 3-7. Sample Report Created From Complete and Partial Records 


Before you decide to use a file with complete and partial 
records, however, look carefully at the possible file 
uses to ensure that you can create all the necessary file 
outputs from such a file. There may be some reports or 
lists you'll want to create that will require all records 
in a file be complete. 


FINISHING THE DESIGN PROCESS 

When you have finished this part of the file design 
process, you should have a File Design Worksheet that 
lists the field description for each field in your file. 
Your File Design Worksheet will be used as the basis for 
creating your file and serves as a written record of your 
file design. 

You're now ready to create an actual IBM Displaywriter 
file. To give you practice, there are file exercises at 
the end of each chapter that allow you to practice the 
concepts you learned in the chapter. Please do not begin 
designing your own file now. Many of the concepts you'll 
be learning interact with each other and affect your file 
design. 
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In the file exercises, there can be more than one correct 
answer. We've tried to identify the most common correct 
answers. Be sure that you understand why an answer is 
correct before going on, because this is the only way we 
can give you feedback about whether you understand a 
concept . 

When you do begin to design your own file, you should 
create the file description and type about 20 records Into 
the file. Then create all the shells that you'll need for 
output and merge these shells with the file. In this way, 
you can identify most potential problems before you've 
typed the entire file. If you have a problem, correct that 
problem in your file and try it again. When you are 
satisfied that the file is workable, finish typing the 
rest of the file. 

If you encounter problems, relax. Remember that you can 
revise your field descriptions and you can add new fields 
to a file by creating new field descriptions. In 
addition, through the duplication process described in 
Chapter 4, you can delete' fields. 
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REVIEW EXERCISES 


1. Circle the variable information in the sample output 
documents below and on the next pages. Identify which 
variable information is the result of a math 
calculation. 

2. After you've finished Question 1., turn the page and 
fill in the File Design Worksheet using the output 
samples as a basis for determining the fields. 

3. In addition to the fields that you've listed from the 
output samples, add fields to track the date of each 
sale. 

Note: The names that you assign to the field may differ 
from those given in the answer on the answer page. Just 
be sure that the information contained in the field is the 
same. 


Sample Output Document 


Dareco Supply Co. 
1407 8th St. 
Phoenix, AZ 85730 


Attention: Mr. Donald F. Smith 

Subject: Power Plants 

Dear Mr. Smith: 

At the request of our Ms. Jones, we are sending you descriptive 
literature and distributor prices covering the above product lines. 

Upon receipt of this information we hope that we shall be favored with a 
trial order against which we will be pleased to send you an invoice. 

Sincerely yours. 


Louis Brown 
Sales Coordinator 


JPJ/( 
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Sample Output Document 




CUSTOMER 

LIST 


Customer 

Contact 

Amount 

Representative 

Cactus Hardware 

Mr. 

Manual Shull 

$18,900.00 

Ortiz 

City College 

Mr. 

Robert Ries 

$67,300.00 

Jones 

City Services 

Ms. 

Suzanne Strayer 

$89,900.00 

Curtis 

Clinical Supply 

Mr, 

Donald Higgins 

$17,450.00 

Jones 

Community College 

Ms. 

Sharon Smith 

$235,980.00 

Ortiz 

Dareco Supply Co. 

Mr. 

Donald Smith 

$10,500.00 

Jones 

Farmers Association 

Mr. 

John Gaus 

$200,550.00 

Hull 

Farrington Co. 

Mr. 

Timothy Sainz 

$42,500.00 

Jones 

Global Industries 

Ms. 

Patricia Ross 

$28,000.00 

Hull 

Hospital Supply Co. 

Ms. 

Donna Ikeda 

$51,790.00 

Ortiz 

Johnson Manufacturing 

Mr. 

Samuel Smith 

$125,890.00 

Hull 

Mayan Construction 

Ms. 

Betty Smith 

$110,700.00 

Ortiz 

Ranchers Inc. 

Ms. 

Brenda Hebert 

$130,890.00 

Hull 

Rural Implements 

Ms. 

Judy Exline 

$26,000.00 

Hull 

State Pipe Co. 

Mr. 

Keith Cronin 

$60,000.00 

Curtis 

State University 

Ms. 

Pamela Ramage 

$54,900.00 

Ortiz 

Thompson Construction 

Ms. 

Betsy McKane 

$64,350.00 

Jones 

Tool Setting Co. 

Ms. 

Leslie Garland 

$32,780.00 

Jones 

Universal Industry 

Mr. 

Thomas Boyd 

$19,975.00 

Curtis 

Wrench Inc. 

Mr. 

Robert Arino 

$32,000,00 

Curtis 

TOTAL: $1,420,355.00 
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Sample Output Document 



REVENUE ANALYSIS BY INDUSTRY 



YEAR-TO- 

-DATE 1981 


INDUSTRY CUSTOMER 

AMOUNT 

TOTAL 

Bid 





Mayan Construction 

$110,700.00 



Thompson Construction 

$64,350.00 

$175,050.00 

Ed 





City College 

$67,300.00 



Community College 

$235,980.00 



State University 

$54,900.00 

$358,180.00 

Frm 





Farmers Association 

$200,550.00 



Ranchers Inc. 

$130,890.00 



Rural Implements 

$26,000.00 

$357,440.00 

Med 





Clinical Supply 

$17,450.00 



Dareco Supply Co. 

$10,500.00 



Hospital Supply Co. 

$51,790.00 

$79,740.00 

Mfg 





Cactus Hardware 

$18,900.00 



City Services 

$89,900.00 



Farrington Co. 

$42,500.00 



Global Industries 

$28,000.00 



Johnson Manufacturing 

$125,890.00 



State Pipe Co. 

$60,000.00 



Tool Setting Co. 

$32,780.00 



Universal Industry 

$19,975.00 



Wrench Inc. 

$32,000.00 

$449,945.00 

YEAR-TO- 

-DATE TOTAL 

$1,420,355.00 


LARGEST 

AMOUNT 

$235,980.00 


AVERAGE 

AMOUNT 

$71,017.75 


NUMBER OF CUSTOMERS 

20 
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FILE DESIGN WORKSHEET 


FIELD NAME 

FIELD 
TYPE^v 

NUMBER OF 
CHARACTERS''^^'- 

COMMENTS 


























































































''character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 
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REVIEW ANSWERS 


Sample Output Document 


Dareco Supply Co. 
1407 8th St. 
Phoenix, AZ 85730 


Attention; 


(mt. D 


onald F. Sm 


3iit^ 


Subject: Power Plants 
DearCMr. SmitT): 


At the request of our(Ms. Jonesy we are sending you descriptive 
literature and distributor prices covering the above product lines. 

Upon receipt of this information we hope that we shall be favored with a 
trial order against which we will be pleased to send you an invoice. 


Sincerely yours. 


Louis Brown 
Sales Coordinator 


JPJ/ce 
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Sample Output Document 



CUSTOMER LIST 



Customer 

Contact Amount 

Representative 


Cactus Hardware \ 


Mr. 

Manual Shull \ 

/$18,900.00 

Orti^ 



City College \ 

Mr. 

Robert Ries 

$67,300.00 

Jones 



City Services 

1 

Ms. 

Suzanne Strayer 

$89,900.00 

Curtis 



Clinical Supply 1 

Mr. 

Donald Higgins 

$17,450.00 

Jones j 


Community College 1 

Ms. 

Sharon Smith 

$235,980.00 

Ortiz 



Dareco Supply Co. 1 

Mr. 

Donald Smith 

$10,500.00 

Jones 



Farmers Association 1 

Mr. 

John Gaus 

$200,550.00 

Hull 



Farrington Co. 

Mr. 

Timothy Sainz / 

$42,500.00 

Jones 



Global Industries 

Ms. 

Patricia Ross 

$28,000.00 

Hull 



Hospital Supply Co. \ 

Ms, 

Donna Ikeda 

$51,790.00 

Ortiz 



Johnson Manufacturing 

Mr. 

Samuel Smith 

$125,890.00 

Hull 



Mayan Construction 

Ms. 

Betty Smith 

$110,700.00 

Ortiz 



Ranchers Inc. 

Ms. 

Brenda Hebert 

$130,890.00 

Hull 



Rural Implements 


Ms. 

Judy Exline 

$26,000.00 

Hull 



State Pipe Co. 


Mr. 

Keith Cronin 

$60,000.00 

Curtis 1 


State University 


Ms. 

Pamela Ramage 

$54,900.00 

Ortiz 1 


Thompson Construction 


Ms. 

Betsy McKane 

$64,350.00 

Jones 1 


Tool Setting Co. / 

Ms. 

Leslie Garland 

$32,780.00 

Jones 


Universal Industry / 

Mr. 

Thomas Boyd / \ $19,975.00 

Curtis 


^rench Inc. y \Mr. 

Robert Arino I \$32,000.00i 

\Curtis 1 

TOTAL : (JiTaZO , 355^ — CAzludoC^^Zx^)^ 



3-24 


Sample Output Document 


INDUSTRY 


(gd) 


(Ed) 


^Med) 


REVENUE ANALYSIS BY INDUSTRY 


YEAR-TO-DATE 1981 


CUSTOMER 


( Tl 


Mayan Construction 
Thompson Construction^, 



City College 
Community College 
State University 


Farmers Association 
Ranchers Inc. 
Rural Implements 


Clinical Supply 
Darqco Supply Co 
Hospital Supply Co 


/Cactus Hardware 
City Services 
Farrington Co. 
Global Industries 
Johnson Manufacturing 
State Pipe Co. 
Tool Setting Co. 
Universal Industry 
Wrench Inc. 


YEAR-TO-DATE TOTAL 
LARGEST AMOUNT 
AVERAGE AMOUNT 
NUMBER OF CUSTOMERS 


AMOUNT 


$110,700.00 
$64,350.00, 


$67,300.00 

$235,980.00 

$54,900^^00, 


'$18,900.00 
$89,900.00 
$42,500.00 
$28,000.00 
$125,890.00 
$60,000.00 
$32,780.00 
$19,975.00 
$32,000.00 


TOTAL 


($ 175, 


050.00 


- CcJucLu^i^iF^ 


($358,180.^0)-C<lA^-^«^^^'^ 



$357,440?0^_^ai^t^fe^>t.- 


$79,740.00 A — < 


Ca/c^uJ^^^^^^^^^ 


CaJcwAiuCct*^ 



^ca^^cMAou&syt- 
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FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE-v 


NUMBER OF 
CHARACTERS--' 


COMMENTS 


^/^c^jjm/uh.y^d 


'd^rrvu 


cAgj 


'/U. 


a:K 


Camfia/nc/ 


/yia/iTULJ 


Ast^ 


lACH- 


X6 



/S 


jr: 


Aita: ^ 'J^^3 A^ a j^^k MA^!(^i^<P^ 


y^^L^ 


A 


ytiJtJ^ (tY f^iryi^^iu:/ Y:iJtAj<ieyt^ 


/^MLQJJ- yiOAriu 


/O 


>^I 


^ 


.//ruL/uo^ jcu^^^^^cj^u^cu^iuryi^ 


S^/Ul/ >^a/yrtJU 


/5 


oSul^dddJn^ 


f 


Z/ytc£e//)6Lj 


YltJyt^y}//iAn>{ 


(^>tJta^>^ 


2225^^ 


A 


/yTLff-f'ct^ft^ jSojo/' cayojeuc;/ 


&ytj:aj^A 


f 


:l 


ZAjdf C^ryvtAc/ 


L^yttabc/' 


f- 


^ 


<9j,,/jtJ^ 




S6Jif£LaJ /xjjDj 


cAaAy 


/^ 


^^to/: 


^^ytA/yruu, 




Zc6Ay 


U^TULCUjOUU 


y^ 


± 


.z^at-y CiXfOLJ 


"Character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 
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Sample of the File Created From the File Design Worksheet 


Rec ID Customer Name 
Last Name Subtitle 

Address 
Contact Month Contact Day 

City 
Contact Yr 

ST 
Order 

Zip 
Sales Re 

Title 
P 

First Name 
Rep Title 

MI 
Ind 

I 
Smith 

Dareco Supply Co. 

01 

1407 8th St. 
05 

81 

Phoenix 

AZ 
10500 

85730 
Jones 

Mr. 

Donald 
Ms. 

F. 
Med 

•1 
Ross 

Global Industries 

01 

913 Dowd Street 
05 

81 

Tucson 

AZ 
28000 

85719 
Hull 

Ms. 

Patricia 

Mr. 

A. 
Mfg 

3 
Sainz 

Farrington Co. 
Jr. 

01 

642 Peach Street 
08 

81 

Pomona 

CA 
42500 

77890 
Jones 

Mr. 

Timothy 
Ms. 

P. 
Mfg 

A 
Boyd 

Universal Industry 

01 

90 Elm Street 
12 

81 

Pomona 

CA 
19975 

77890 
Curtis 

Mr. 

Thomas 

Mr. 

L. 
Mfg 

5 
Smith 

Mayan Construction 

01 

66 Ash Street 
12 

81 

El Centro CA 
110700 

77459 
Ortiz 

Ms. 

Betty 
Ms. 

Bid 

6 
Caus 

Farmers Association 

02 

356 Rural Road 
13 

81 

El Centro CA 
200550 

77459 
Hull 

Mr. 

John 
Mr. 

E. 
Frm 

7 
Garland 

Tool Setting Co. 

02 

1240 9th Street 
21 

81 

Phoenix 

AZ 
32780 

85730 
Jones 

Ms. 

Leslie 
Ms. 

A. 
Mfg 

8 
Rics 

City College 

02 

23 N. Central 
25 

81 

Tucson 

AZ 
67300 

85719 
Jones 

Mr. 

Robert 
Ms. 

J. 
Ed 

9 
Exline 

Rural Implements 

02 

2456 River Road 
27 

81 

Tubac 

AZ 
26000 

85620 
Hull 

Ms. 

Judy 

Mr. 

K. 

Frm 

10 
Ramage 

State University 

03 

56 W. 10th Street 
12 

81 

Nogales 

AZ 
54900 

85621 
Ortiz 

Ms. 

Pamela 

Ms. 

I. 
Ed 

1 1 
Cronin 

State Pipe Co. 

03 

45 E. Sand Road 
16 

81 

Nogales 

AZ 
60000 

85621 
Curtis 

Mr. 

Keith 

Mr. 

D. 

Mfg 

12 
Ikeda 

Hospital Supply Co. 

03 

2 W. Almeda 
20 

81 

San Diego CA 
51790 

77892 
Ortiz 

Ms. 

Donna 

Ms. 

P. 
Med 
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CHAPTER SUMMARY 


Analyzing current information management procedures 
requires answering the following questions: 

— What files are kept now? 

— What fields make up these files? 

- How is the information in the files used? 

Potential design problems and the recommendations for 
avoiding them are: 

- Names - Use five fields: title, first name, 
middle initial, last name, and subtitle 

- Addresses - Use four fields: street, city, state, 
and zip code 

- Dates - Use four fields: a printing date, and 
year, month, and day fields 

— Field with alphabetic and numeric information - 
separate into different fields 

— Combined fields - use only if you need the extra 
fields made available by compressing the 
information into one field 

Complete and partial records can be used in some 
types of files and may save space and typing time by 
reducing the amount of redundant information that 
must be typed. 

The File Design Worksheet was used in this chapter. 
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Creating A File 


Creating a file requires only two steps. First, using the 
File Design Worksheet, you create a file description that 
contains a field description for each field. Second, 
after the field descriptions are created, the actual file 
information is typed. 

This chapter contains information about: 

• creating a file description 

• adding records to the file by typing them 

• adding records that were created on other equipment 
to the file 


CREATING A FILE DESCRIPTION 


The information for the field description can be taken 
directly from the File Design Worksheet. The field name, 
field type, and maximum field length for each field are 
entered on a field description menu similar to the one 
shown in Figure 4-1. 
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FILE DESIGN WORKSHEET 



FIELD NAME 


f^Mt^ 


rMuo:^ ^O/yyuu 


>r?^ 


<^f ^ . 


>»t<gt*»Ot-. 


^JJL^M^ 


^;;^ juLt ^^ZoCfi^ iMo-. 



sL 


FIELD 
TYPE* 


cA^^ 


NUMBER OF 
CHARACTERS'" 


/O 


/s 


^ 


^6 


/:5 


COMMENTS 


>^ytg^a^i^^ii3A>td&<tZ«a>o 


./>9i£j^L^i^ ^O'U^uaiea^^cgyij 


^^^L." 


aj^-&-*UAACa?6arL . 


Create Field [Personnel File 

1 1 

DISKOll 1 1 1 

1 1 

FIELD DESCRIPTION 


YOUR 

POSSIBLE 

ID ITEM CHOICE 

CHOICES 

a Field Name Title 


b Field Type 2 

1 = Math 


2 = Character 


3 = Text 

c Maximum Length 4 

1-17 : Math 


1-80 : Character 


1 - 500 : Text 

When finished with this menu, press ENTER. 


Type ID letter to choose ITEM; press ENTER: 



Figure 4-1. Field Description Menu 


4-2 


Record ID 


Field Order 


The first field in every file is a system-generated 
field, Record ID. The system uses this field to track 
records, and it assigns the Record IDs in increments of 
one. Thus, the first record typed into the file is 
assigned Record ID 1, the second record is Record ID 2, 
and so on. Each time a record is added, it is assigned a 
Record ID one digit higher than the Record ID of the last 
record in the file. If a record is deleted, the Record 
IDs of the other records in the file remain the same, and 
the Record ID of the deleted record is unused. 

While you cannot directly change the Record ID of a 
record, you can use the system to renumber the records so 
that any unused Record IDs are used. For example, if the 
record with Record ID 3 was deleted. Record ID 3 cannot be 
used for another record unless you use the system to 
renumber the records. When records are renumbered, the 
Record IDs are assigned in the same order as the records 
are stored in the file. 


Each field appears in the record in the same order as the 
field descriptions were created. For instance, the first 
field description created is the first field in the file 
(after the Record ID, which is inserted automatically), 
the second field description created is the second field, 
and so on. Figure 4-2 shows how the file headings appear 
on the screen after all the field descriptions are 
created. A heading line displays the name of each field. 


Merge File/Text | Personnel File | | 
DISKOlj 1 1 1 |Kyb 1 | 


RECORD SELECTION 



Rec_ID 

Title 

First Name 

MI 

Last Name 

Subtitle 


1 

w 

w 

w 

w 

w 


Figure 4-2. Sample Record Screen 


The order in which the fields appear in the file does not 
generally matter. You can temporarily rearrange the 
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fields in any order for such tasks as revising the record. 
Before the file is printed you usually will rearrange the 
fields in the file and print only some of the fields . 

As a general rule, if most of the file information comes 
from a single form or source document, create the field 
descriptions so that the fields are in the same order as 
they appear in the source documents. It may be easier to 
type in the information if you can simply follow the form. 
If, however, the file information comes from many 
sources, you may want to arrange the fields in whatever 
order seems convenient for the person who must compile 
the information. 


ADDING RECORDS TO A FILE 


Adding Typed Records 


New records can be added to a file by more than one 
method. Typing the records is the most common method of 
adding records. However, records can be added that were 
originally: 

• typed as text documents 

• created on other compatible office equipment 

• communicated from a suitably programmed host computer 

You can use combinations of the methods described in this 
chapter to add records to a file. For example, you may 
duplicate selected records to the file, then type some 
records, and add others previously typed as text. The 
primary consideration for adding records is that the 
records added must be compatible with the field names, 
field types, and maximum field lengths defined in the 
file description. 


As you type the file information, the system checks the 
information against the field description for that field. 
The system allows you to type only characters that are 
consistent with the field description for that field. 

For example, if you try to type an alphabetic character in 
a math field, the system will not accept the character and 
will inform you that the alphabetic character is invalid 
in that field. The system will respond in a similar 
fashion with a different error message if you try to type 
more characters than the maximum field length allows. 
This system checking helps insure the integrity of the 
information in a file. 
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Adding Records From Other Sources 


Records can be added in several ways besides being typed 
directly into the file. There are four major sources of 
records : 

1. Records typed on the Displaywriter System as a text 
document, such as a variable fill-in list or a 
statistical table 

2. Records created on other compatible office equipment, 
such as an IBM Office System 6, the IBM 5520 
Administrative System, or any IBM mag card typewriter 

3. Records stored on a suitably programmed IBM computer 

4. Records from one IBM Displaywriter file added to 
another existing IBM Displaywriter file or used to 
create a new file 
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Records Converted From Text 


The same method is used to add records created on other 
compatible office equipment or typed as a text document 
to an IBM Displaywriter file. The original information 
must first be stored as a text document. Records that 
were created on other office equipment must be either 1) 
communicated to the IBM Displaywriter System as text or 
2) if the information is stored on magnetic cards, it can 
be read into a text document via an IBM 6361 Mag Card 
Reader. 

Once the information is as a text document, it can be 
converted into an IBM Displaywriter file. For a document 
to be converted, the format of the text within the 
document must be such that it can be divided logically 
into records and fields compatible with the records and 
fields defined in the IBM Displajiwriter file. 

Appendix C explains the conversion rules and 
considerations involved in converting text into a file. 


Records Received From Computer 


A file stored on a suitably programmed host computer can 
be communicated to the IBM Displaywriter for file use. 
When the file is communicated, the IBM Displaywriter 
receives it as a text job. It then must be converted to a 
file. For instructions on converting text into a file 
job, see Appendix C. 

Before the file is communicated from the computer, you 
should consult the data processing personnel who handle 
the computer file to determine the file contents. All of 
the same file concerns discussed in Chapter 3 still 
apply. You will want to look at the computer file fields 
that contain names, addresses, dates, and other items to 
determine whether the information is usable. 

In some cases, the computer file may have to be altered 
before it is communicated to the IBM Displaywriter. For 
example, the name field in the computer file may contain 
the entire name, and the proposed file output may require 
that the name be broken into more than one field. You can 
either: 

• divide the field while the file is stored as a text 
job, then convert the file, or 

• before that information is communicated to the IBM 
Displaywriter, the name field can be divided into 
separate fields 
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A field, however, cannot be automatically divided after 
the file is stored on the IBM Displaywriter System as a 
file. 


Duplicating Records From Another IBM Displaywriter File 


You may have records in one IBM Displaywriter file that 
can be used in another IBM Displaywriter file. Rather 
than retyping these records, you can duplicate some or 
all of the records in the source file. The Duplicate 
Selected Records function allows you to: 

• duplicate all of the records from a source file or 
duplicate only selected records 

• duplicate some or all of the fields in a file 

• rearrange the order of the fields within a record so 
that the fields appear in a new file in a different 
order 

• sort the records to duplicate them to the new file in 
a specific order 

There are two situations in which you might use the 
Duplicate Selected Records function to add records to a 
file. In the first case, you use the records to create a 
new file, and in the second, you add the records to an 
existing file. 

DUPLICATING RECORDS TO CREATE A NEW FILE : When you 
duplicate records to create a new file, you do not have to 
create new field descriptions. If you don't create new 
field descriptions, the source file field descriptions 
are automatically duplicated along with the records. 

The new file has its own Record IDs. The first record 
duplicated is Record ID 1, the second is Record ID 2, and 
so on. 

DUPLICATING RECORDS TO AN EXISTING FILE: At other times, 
you might find it useful to add records from one file to 
another file. 

During duplication, the source file and the destination 
file (the file being added to) are compared. Only those 
fields in the source file with field names identical to 
the field names in the destination file are copied. If 
you want to duplicate records into a file and the field 
names do not match, you must change the field names in one 
of the files. For example, if one file has a field named 
AMT and the same field in the other file is named Amount, 
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you cannot duplicate the records until you change that 
field name in one of the files. 

The field types do not have to match, as long as the 
information in a field is not in violation of the new 
field description. (For example, you can not duplicate 
alphabetic characters into a math field.) 

The maximum field length of a field in the destination 
file can be either shorter or longer than the maximum 
field length of that field in the source file. 

During the duplication process, the system checks each 
record before duplicating it into the destination file. 
If it finds a field that contains either 1) more 
characters than allowed by the maximum field length for 
that field in the source file, or 2) characters that 
violate the field type for that field in the destination 
file, then it duplicates that record into an error file. 
You can look at the error file after the duplication 
process is completed. If you still want to duplicate 
these records, the error must be corrected before 
duplicating the records from the error file to the 
destination file. 


SOURCE FILE 


\/ 


DUPLICATION FIELD CHECK 

L. Does field exceed new 
maximum length? 

I. Are characters in field 
incompatible with new 
field type? 


If YES to either 
question, move 

record to 


ERROR FILE 


If NO to both 
questions, move 
record to 


\/ 


DESTINATION FILE 


Creating new field descriptions, and then duplicating the 
information from an existing file into the new file 
provides you with an opportunity to correct some design 
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errors. For example, you find that you described a field 
containing all numbers as a character field, but you now 
want use the information in that field in math 
calculations. You cannot change the original* field 
description, but you can set up a new file description 
that is correct. Then you can duplicate the records from 
the existing file into the new file. 

DUPLICATING AN ENTIRE FILE: Duplicate Selected Records 
can be used to duplicate an entire file. However, you can 
also duplicate an entire file just as you would duplicate 
a text document. To do this, you must duplicate all the 
records in the file and all the fields in each record. The 
new file is an exact duplicate of the old file, and the 
Record IDs are the same in both files. 

You can use this mode of duplication if you have a file 
that you want to copy while preserving the Record IDs. 
For example, you may want to make a copy of the file to 
serve as a backup file. The backup file could be used if 
the original file is accidentally damaged or destroyed. 


OTHER RECORDS FUNCTIONS 


The IBM Displaywriter has some additional functions that 
help with file information management. First, the system 
can count all selected records (those that meet specific 
selection criteria) and display the total. This function 
can be useful in evaluating file content. 

Second, the system can automatically delete selected 
records. You can specify selection criteria and delete 
any record that matches the selection criteria. This 
function allows you to delete more than one record 
without having to look at each record separately. If you 
have records with expiration dates, for example, you 
might want to delete those records when those expiration 
dates occur. 
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REVIEW QUESTIONS 


True/false. You can choose not to have Record IDs in 
your file. 

True/ false. Rearranging fields for editing or 
printing does not permanently change your file. 

What two things does the system check for as 
information is added to the file? 


4. True/false. Using Duplicate Selected Records to 
duplicate the file prevents you from duplicating all 
the records in the file. 

5. True/ false. If you are duplicating records into an 
existing file, the system will recognize AMT and 
AMOUNT as being the same fields. 
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REVIEW ANSWERS 


1. False. Record IDs are system-generated, and each 
record in a file must have a Record ID. 

2. True. Rearranging fields for editing or printing is 
only a temporary change. It does not permanently 
change your file. The only way to permanently change 
the order of the fields in a record is to duplicate 
the file using Duplicate Selected Records. You can 
then specify that the fields appear in the new file in 
a specific order. 

3. As information is added to the file, the system 
checks it to be sure that the information does not 
violate the field type for that field and that the 
maximum field length is not exceeded. 

4. False. Using Duplicate Selected Records to duplicate 
the file does not prevent you from duplicating all 
the records in the file. It does, however, allow you 
to do some additional record handling such as sorting 
records, duplicating only some fields, or rearranging 
the order of the fields. 

5. False. If you are duplicating records into an 
existing file, the system will not recognize AMT and 
AMOUNT as being the same fields. It will not 
duplicate the contents of one of these fields into 
the other. The field names must be identical for 
successful duplication. 
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CHAPTER SUMMARY 


A file description must be created and stored on 
diskette before you can add records to a file. 

The field descriptions that make up a file 
description list the field name, type, and maximum 
length for each field in the file. 

A Record ID is added to every record by the system. 
The operator cannot change a Record ID, but can use 
the system to renumber all records. 

The field order can be temporarily rearranged for 
editing or printing. 

Records from the following sources can be added to a 
file: 

— converted from a text document 

— received from a suitably programmed computer 

— duplicated from another Displaywriter file 
Other records functions include: 

— counting the number of records 

~ deleting multiple selected records 
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FILE OUTPUT 


File Output 

This chapter contains information about: 

• the possible output media for a Displaywriter file 

• unformatted output directly from the file 

• output created by merging the file with a shell 
document 

• conditional text that prints under some 
circumstances, but not others 

There are three possible types of file output: 

1. The file can be printed, either directly from the 
file or after being merged with a shell document. 

2. The file output can be stored as a text document on a 
diskette, either directly from the file or after 
being merged with a shell document. The file output 
is the same as it would be if it had been printed. 

3. The file output can be both printed and stored on 
diskette, either directly from the file or after 
being merged with a shell document. 

For convenience, any time we talk about a file being 
outputted, we will say that it is printed. However, 
remember that there are more ways to output the file than 
just printing. 


FILE OUTPUT WITHOUT MERGE 


Printing a file using the system-generated format 
produces a document like Figure 5-1. The system provides 
a page header that contains the field names directly 
above the field entries. The header and records are 
wrapped (moved to the next line) if multiple lines are 
necessary. They are wrapped only at field boundaries, 
where possible. 

The space provided for each field is wide enough to hold 
the maximum- length field value allowed for that field, as 
specified in the field description. If the field name is 
longer than the maximum length for that field, then the 
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Rec ID Title First 

Name MI 

Last Name 


Subtitle 

Street Address 


City 




State Zip Code 

Home Phone FN Spouse 

Yr Born Mo Born 

Day Born 

Department 

Supervisor 

App Date 

Salary 

Sex 

Extension Hire Yr 

1 Mr. Brian 

K. 

Rogers 





345 West 6th Street 


Dallas 




TX 71098 

764-1293 Jane 

41 

12 


24 


Administration 

Roger Kramer 

81/01/05 

13495 

M 


7462 

65 

2 Mrs. Lorna 

A. 

Boyle 





122 North 10th Street 


Dallas 




TX 71283 

736-2938 David 

51 

04 


08 


Engineering 

Ronald Crawford 

80/05/20 

16998 

F 


2736 

75 

3 Ms. Sue 

R. 

Burns 





1054 Great Oak Road 


Dallas 




TX 71234 

746-2839 

55 

12 


18 


Administration 

Roger Kramer 

81/01/15 

10500 

F 


2938 

80 

4 Mr. Gerald S. 

Ostrom 



Jr 


1020 Far West Drive 


Dallas 




TX 71923 

659-2837 Janet 

37 

07 


31 


Marketing 

Patricia Nicholson 

80/12/05 

25998 

M 


1726 

55 

5 Ms. Trisha J. 

Park 





1532 Wilshire Drive 


Irvine 




TX 73928 

432-5938 John 

45 

06 


11 


Planning 

Pauline Shaw 

80/11/15 

24445 

F 


3948 

70 


Figure 5-1. File Output Without Merging 
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length of the field name is used to determine how much 
space is allowed for that field. 

The field entries are printed exactly as they appear on 
the screen. Numbers are printed as they were typed. 
Include Instructions in a text field are not resolved and 
do not retrieve any text (as they normally would if the 
file were merged and printed) . 

Before printing the file, you can: 

• temporarily rearrange the order of the fields 

• temporarily delete fields you don't want printed 

• select records using the select function described in 
Chapter 6 

• sort the file using up to five sort fields, as 
described in Chapter 7 

You can also create a format document that can be used 
with the file output. A format document, as its name 
implies, is used only to provide format information for 
the file output. (It is not a shell document and cannot 
contain any text.) With a format document, the file can be 
printed: 

• sideways on the paper 

• with the fields lined up 

• with text headers or footers, including page numbers 

However, the space provided for each field is still 
determined by the maximum field length or the length of 
the field name, whichever is longer. 
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Rec ID First Name MI Last Name 
Street Address City 
Department Extension 

State 

Zip Code 

1 Brian K. 
345 West 6th Street 
Administration 7462 

Rogers 

Dallas 

TX 

71098 

2 Lorna A. 
122 North 10th Street 
Engineering 2736 

Boyle 

Dallas 

TX 

71283 

3 Sue R. 
1054 Great Oak Road 
Administration 2938 

Burns 

Dallas 

TX 

71234 

4 Gerald S. 
1020 Far West Drive 
Marketing 1726 

Ostrom 

Dallas 

TX 

71923 

5 Trisha J. 
1532 Wilshire Drive 
Planning 3948 

Park 

Irvine 

TX 

73928 

6 Roger T. 
2045 Duval Road 
Accounting 2837 

Norton 

Dallas 

TX 

76452 

7 Laverne W. 
2020 Madison Avenue 
Administration 2839 

Kelly 

White Rock 

TX 

73648 


Figure 5-2. File Output Using a Format Document 


MERGE FILE/TEXT OVERVIEW 


In merge file/text, a file is merged with a shell 
document. The shell document describes the desired format 
of the output and identifies fields from the file to be 
inserted into the output document. It also identifies 
where the fields and any constant text or associated text 
are to be inserted. Text processing functions, such as 
headers, footers, pagination requirements, and page 
numbering, can be used with shell documents. The shell 
document is stored and can be reused. 

When the shell document is merged with a file, the system 
inserts the information contained in the fields specified 
into the output document. The number of output documents 
produced depends on the type of merge file/text being 
done and the number of records selected. 
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You can merge a file with text to produce either reports 
or repetitive letters. The repetitive letter function 
allows you to combine fields from individual records with 
a shell document to produce one output document per 
record. See Figiirfe 2-2 in Chapter 2 for an example of 
repetitive letters produced from a file. 

Reports allow you to combine fields from all selected 
records with a shell document to produce one output 
document. See Figure 2-3 and Figure 2-4 in Chapter 2 for 
an example of reports and lists generated from a file. 
Notice that reports and lists use the information from 
more than one record. 


Creating a Shell Document 


Shell documents are created in a text mode. At the point 
in the document where information from a field is to 
inserted, the operator uses a Variable key to tell the 
system that the inserted information will differ in each 
letter. 

The variable information can be: 

• a field name 

• a field number (the first field added to the file 
would be field 1, etc.) 

• an answer variable from an math calculation 

If the variable information is information from a 
math field or an answer variable from a math 
calculation, then a math format can also be 
specified. (Chapter 9 contains more information on 
math formats . ) 

Figure 5-3 shows a shell document with variable 
information as it appears if the shell document is 
printed without merging it with a file. The variable 
information appears surrounded by the variable sign, -V-. 
All instructions (such as Include Instructions and Math 
Instructions) are surrounded by a /. 
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./years__service = 81 - Hire_Yr/ 
/percent ~ years__service * .01/ 
/bonus = percent * Salary/ 


December 15, 1981 


VTitleV VFirst_NaineV VMIV VLasC_NameV/lf Not Emptyji_Subtitle/, VSubtitleV/End If/ 

VStreet__Address¥ 

VCity¥, VState¥ ¥ZipjCodeV 

Dear VTltleV VLastJMaraeV: 

This past year has been a banner year for us, and we would like to thank you for your 
help in making it that way. I'm pleased to announce that the Board of Directors has 
voted to give each employee a bonus of 1% of his or her salary for each year of 
service. 

Since you have been with us for Vyears_service_j^3V years, your bonus is $¥bonus_j_l¥. 
This amount will be added to your next paycheck. 

Again, I'd like to thank you for your help and congratulate you on a fine year. 


Sincerely, 


Dan P. Andrews 
President 


December 15, 1981 


Mr. Brian K. Rogers 
345 West 6th Street 
Dallas, TX 71098 

Dear Mr. Rogers: 

This past year has been a banner year for us, and we would like to thank you for your 
help in making it that way. I'm pleat-.ed to announce that the' Board of Directors has 
voted to give each employee a bonus of 1% of his or her salary for each year of 
service. 

Since you have been with us for 16 years, your bonus is $2,159.20. This amount will 
be added to your next paycheck. 

Again, I'd like to thank you for your help and congratulate you on a fine year. 


Sincerely, 


Dan P. Andrews 
President 


Figure 5-3. Sample Shell Document and Letter 
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The shell document can also contain conditional text, 
which is text is printed only under certain 
circumstances. Conditional text is explained in the next 
section. 


How to Use Conditional Text in Merge File/Text 


At times you may want to have text printed if there is an 
entry in a field, but not if the field is blank (has no 
entry). For example, if a person's name has a subtitle 
(such as Jr. or III) you'll want to print the person's 
name, a comma and a space, then the subtitle (for example, 
George A. Johnson, Jr.). But if there is no subtitle, then 
you don't need the comma and space after the name. 

If you put the comma and space in your shell document as 
constant text, you'll get names like "Susan K. Brown, ", 
because the comma and space will print after every name. 

The conditional text function allows you to tell the 
system that certain specified text is to be printed only 
under certain conditions . There are three different 
possible conditions. 

1. The conditional text is to be printed only if there is 
an entry in the specified field. For instance, a 
comma and a space after a name will print only if 
there is an entry in the subtitle field. If the 
subtitle field is empty, the comma and space will not 
print. 

2. The conditional text is to be printed only if there is 
not an entry in the specified field. 

For example, a letter to employees notifying them of 
missing information in their personnel records might 
be set up so that if a field is blank, a sentence 
identifying the missing information is printed (for 
example, "We do not have your current home telephone 
number."). Otherwise, if the field has an entry, the 
sentence does not print. 

3. One piece of conditional text is to be printed only if 
there is an entry in the specified field; otherwise, 

a different piece of conditional text is to be 
printed. 

As an example. Figure 5-4 shows two letters sent to 
employees. If there is a name in the FN Spouse field, 
the employee's spouse's name is printed from the 
file. But if the field is blank, the phrase "a 
companion" is printed. (The shell document is also 
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shown, with the conditional text instruction 
highlighted. ) 


January 5, 1982 

VFirst_NameV ¥MIV VLastJiameVfliWoi'E^tyTSuit^^ /End If/* 

VStreet_AddressV "' ■""""'"* * 

VCityV, VStateV VZip_CodeV 

Dear VTitleV VLast_NameV: 

I am delighted to announce that our fifth annual company dinner will be held 
January 16, 1982 in the Executive Dining Room to celebrate a good year. I am 
hoping that you'll be attending. Please allow me to extend an invitation to you 

and ^If ' Not'^Eiapt7|;?lf<S^Su^^fE|;^fw liJ^Tf 'Empty jFif_Sp'QUse-f a companlcm*?End^SI?3 

In addition to the dinner, there will be dancing afterwards. 
Please RSVP to your department secretary by January 10. 

Sincerely, 


Dan P. Andrews 
President 


Figure 5-4 (Part 1 of 2). Sample Letters With Conditional Text 
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January 5, 1982 

Brian K. Rogers 
345 West 6th Street 
Dallas, TX 71098 


Dear Mr. Rogers: 

I am delighted to announce that our fifth annual company dinner will be held 
January 16, 1982 in the Executive Dining Room to celebrate a good year. I am 
hoping that you'll be attending. Please allow me to extend an invitation to you 

and sJar^. 

In addition to the dinner, there will be dancing afterwards. 
Please RSVP to your department secretary by January 10. 


Sincerely, 


Dan P. Andrews 
President 


January 5, 1982 

Sue R. Burns 

1054 Great Oak Road 

Dallas, TX 71234 


Dear Ms. Burns: 


I am delighted to announce that our fifth annual company dinner will be held 

January 16, 1982 in the Executive Dining Room to celebrate a good year. I am 

hoping that you'll be attending. Please allow me to extend an invitation to you 
and a companion. 

In addition to the dinner, there will be dancing afterwards. 

Please RSVP to your department secretary by January 10. 

SincereJy , 


Dan P. Andrews 
President 


Figure 5-4 (Part 2 of 2) . Sample Letters With Conditional Text 
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A conditional text instruction is made up of three parts: 

1. the name of the field that the conditional text is 
based on (in Figure 5-4 the field was FN Spouse) . 

2. whether the field should have an entry for the 
conditional text to print, or whether the field 
should be empty. 

3. the text that is to be printed. This can be both 
constant text and information from the file. If you 
want to print information from the file, you must 
specify each field name as a variable just as you do 
in the regular text in the shell document. 

Note: When you use conditional text, a math field 
containing only a (zero) is read as blank (no entry) , 
but a character field containing a single space is read as 
having an entry. 
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This page intentionally left blank. 
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REVIEW QUESTIONS 

1. True/false. All file output must be printed. 

2. True/false. A list is a type of repetitive letter 
since it repeats file information. 

3. True/ false. Variable information can come from the 
file or from a math calculation. 

4. Write the conditional text instruction for the 
examples below. For each example, fill in: 

1. If "Field Name" 

2 . is "Not Empty/Empty" 

3. print "Conditional Text" 

a. Your file has a field named "Salutation" to 

provide the salutation for letters. If you don't 
have a name in this field, you'd like the word 
"Gentlemen" placed in the salutation of your 
letter. 

1. If 

2. is 


3. print 


Your file has a field named "Letter" that 
contains a date that a customer was sent an 
important sales letter, but not all customers 
were sent the sales letter. You want to send 
another letter to all customers, but you want to 
print "We sent you a letter earlier this year." 
in the letter to the customers who received the 
first letter. 


1. If 

2. is 


3. print 
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Your employee file has a field named 
"EmerContact" which contains the name of a person 
to be contacted in the event of an emergency. You 
want to send out a memo to have employees verify 
that the contact name is correct. If there is a 
contact name, the memo should read "Our records 
show that the person to be contacted in case of an 
emergency is (fill in the person's name)." 

If the record doesn't shows a contact name, you 
want to ask the employee to provide one by 
saying, "You have not designated someone to be 
contacted in case of an emergency. Please do so 
as soon as possible." 

1. If 


IS 


3. print 


BUT 


1. If 


2 . is 


3. print 
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REVIEW ANSWERS 


1. False. File output can be printed, stored on a 
diskette as a text job, or both. 

2. False. A list is a type of report since it produces 
one output document for a file. A repetitive letter 
produces one output document for each record. 

3. True. Variable information may be either file 
information or an answer variable from a math 
calculation. 


a. 


b. 


c. 


1. If Salutation 

2 . is empty 

3. print "Gentlemen." 

1. If Letter 

2. is not empty (has an entry) 

3. print "We sent you a letter earlier this 
year. " 

1. If EmerContact 

2. is not empty (has an entry) 

3. print "Our records show that the person 
to be contacted in the case of an emergency 
is ¥EmerContact¥. " 

BUT 

1. If EmerContact 

2 . is empty 

3. print "You have not designated someone to 
be contacted in case of an emergency. Please 
do so as soon as possible." 
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CHAPTER SUMMARY 


File output can be: 

- printed 

- stored on diskette as a text job 

- stored on diskette as a text job and printed 

File information can be outputted directly from the 
file without merging it from a shell document, but it 
prints in a system-generated format. 

Merge file/text is used to merge a file with a shell 
document. There are three types of merge file/text: 

1. repetitive letters which produce one output 
document per record 

2. reports which produce one output document per 
file 

3. lists which produce one output document per file 
A shell document can contain as variables: 

- field names 

- field numbers 

- answer variables from math calculations 

Conditional text is used to print text under certain 
conditions and not print it under others. Depending 
on the conditional text instruction, conditional text 
may print : 

1. if the specified field is not empty (has an 
entry) 

2. if the specified field is empty 

3. or two conditional text instructions can be 
combined so that one piece of text prints if the 
field is not empty and a different piece of text 
prints if the field is empty 
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Selecting Records 


Once your file has been created, you'll want to begin 
using it. One of the important criteria for files 
management discussed in the introduction is the 
capability to select or choose certain records for use. 
IBM Displaywriter record selection allows you to do this. 

Record selection involves searching the file for records 
that meet the record selection criteria typed into the 
Record Selection frame. Each record in the file, 
beginning with the first, is compared against the 
criteria. If the record matches the criteria, it is 
displayed, merged, printed, or duplicated; if it does not 
match, it is not used and the next record is compared 
against the criteria. 

Each record selection criterion consist of three parts: 

1. the field to be searched, 

2. a comparison criterion (such as "greater than") which 
specifies the basis for comparison, and 

3. the comparison value that the value in the field must 
match. 


COMPLETING THE RECORD SELECTION SPECIFICATIONS 


Record Selection Specifications are used with most of the 
worksheets you'll be using, such as the Report Design 
Worksheet (which is discussed in Chapter 11). You'll use 
the Record Selection Specifications to specify the 
selection criteria to be used for those outputs. To 
complete the Record Selection Specifications, you'll need 
to list the: 

1 . field name 

2. comparison criteria 

3. comparison value for each field. 

4. logical criteria(s), if there is more than one 
comparison criterion for a field 

5. line number, if there is more than one line of 
selection criteria 

In the rest of this chapter, you'll learn how to use 
record selection. A completed Record Selection 
Specifications sheet is shown with each sample record 
selection frame. 
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COMPARISON CRITERIA 

There are four primary comparison criteria: 

• = (equal to) means that the characters in the field 
being searched must match the comparison value 
exactly. If you are searching a field named "State" 
for a value equal to California, only those records 
with California in that field will be selected. You . 
can also search for a record that has no value in a 
field by specifying =' ' . 

• i- (not equal to) means that the characters in the 
field being searched must not match the comparison 
value. You use this comparison criterion to exclude 
a group of records from use. 

• > (greater than) means that the value in the field 
being searched is higher than the comparison value. 
If you are searching a field named "Salary," you may 
not be interested in records where the salary is 
exactly the same as the one you specify, but you want 
the records selected when the salary is more than a 
certain amount. 

Think of the letters of the alphabet as being 
numbered, with A=l and Z=26. If you use >K in a 
character field, for example, the letters selected 
will be those that follow K in the alphabet. 

• < (less than) means that the value of the number in 
the field being searched is lower than the comparison 
value. Again, you may be searching for records that 
have a salary less than the amount you specify. 

In addition, these comparison criteria can be combined to 
give you two more comparison criteria: 

• => or >= (equal to or greater than) means that the 
number in the field being searched is the same as the 
comparison value or higher. For example, you might 
search a field named "Salary" for those salaries 
equal to or greater than $15,000. 

• =< or <= (equal to or less than) means that the number 
in the field being searched is the same as the 
comparison value or less. You also might search a 
field named "Salary" for those salaries equal to or 
less than $15,000. 
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LOGICAL CRITERIA 


In many cases, you'll search for a value between two 
limits or a value matching one of a number of criteria. 
To do so, you use logical criteria along with the 
comparison criterias . The two logical criteria are: 

1. & (AND) 

2. I (OR) 

An & (AND) tells the system that for a value in a field 
to be selected, it must meet all the selection criteria 
listed. For example, if you want to print a list of 
everyone in the file whose salary is greater than $10,000 
and less than $20,000, you would do the following. You 
already know that your comparison criteria would be 
>10000 and <20000, so you simply replace your verbal 
"and" with the logical criteria & to create >10000 & 
<20000. 

The record selection frame would look like the Record 
Selection frame shown below. (For clarity, we've 
rearranged some of the fields and deleted the fields that 
we aren't using, just as you might do. We'll also show you 
only a partial representation of the Record Selection 
frame . ) 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
■ LINE ■ 

■ FIELD 

SELECTION CRITERIA 

I 

Jyo/a/u^ 

>IOOOO /^Zooao 


" w 















•^J^SSir 


Rec_ID 

First Name 

MI 

Last_Name 

Salary 





> 10000 6c < 20000 
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An I (OR) tells the system that for a record to be 
selected, the value in the field can match any of the 
selection criteria for that field. For example, if you 
want to select the records of anyone who is in either the 
Engineering or Personnel department, you know that you 
would specify = Engineering or = Personnel. Now just 
replace the your verbal "or" with the logical criteria | . 
The record selection frame, with the fields rearranged 
for easier revision, would look like this: 


RECORD SELECTION SPECIFICATIONS 


SELECTION 

■ um ■ 


FIELD 


SELECTION CRITERIA 


/ 


3^jm^Jt?miAct 


f^14i4mAJ^i^ /. -AfA/i^ytml. 


First Name 

Last Name 

Salary 

Department 




= Engineering | = Personnel 


You can also use combinations of AND and OR. Just keep in 
mind that any selection criteria linked with ANDs will 
all have to be met for a record to be selected. If the 
selection criteria are linked with ORs , any record 
meeting any of the selection criteria will be selected. 

Suppose you want to compare the records of employees 
hired in the first quarter and the last quarter of the 
year. To set up your selection criteria, you need to tell 
the system to select the records with dates in January, 
February, and March (first quarter) and October, 
November, and December (last quarter). The dates are 
typed as numbers in the Month field. 
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The first part of the selection criteria would be 
selecting records for the first quarter. The selection 
criteria might be one of the following: 

Month => 01 & Month =< 03 

Month = 01 I Month = 02 | Month =03 


The first method of writing the selection criteria sets a 
range between 01 and 03. If a date is 01, 03 or between 
those two numbers, it will be selected. The second method 
of writing the selection criteria contains a list of all 
the months that a date could match and be selected. Either 
method is correct, but we'll use the first method, 
creating a range, in our example. 

The selection criteria for selecting the employees hired 
in the last quarter of the year is same, but with 
different months as comparison values. When the two sets 
of selection criteria are combined, they must be combined 
with an | (OR) sign so that the selection criteria is: 

Month => 01 & Month =< 03 | Month => 10 & Month =< 12 

First Quarter Last Quarter 


Notice that in the selection criteria, the | (OR) sign 
separates the selection criteria into two sets of 
selection criteria. A hire date that falls into the first 
quarter or the last quarter would be printed on the list. 

The & (AND) sign connects all the selection criteria up to 
the limits of the | (OR) sign and allows each range to be 
specified separately. 

If you had used an & (AND) sign instead of an | (OR) sign 
in the previous example, your selection criteria would 
have been: 

Month => 01 & Month =< 03 & Month => 10 & Month =< 12 

The selection criteria above will not produce a list 
because it asks for dates that are between January and 
March and also between October and December. (Remember 
that an & (AND) means that all selection criteria must be 
met for a record to be selected.) But it is impossible 
for a date to be in both quarters, so no record would be 
selected. 
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SELECTING RECORDS BASED ON THE CRITERIA IN MORE THAN ONE LINE 

The record selection frame (such as the one in 
Figure 6-1), has room for up to 12 lines of selection 
criteria under each field name. When multiple lines of 
selection criteria are used, the system assumes an | 
between each line. 

Figure 6-1 shows two lines of selection criteria. The 
system reads the selection criteria and selects any 
record that contains the name of a person: 

1. in the Engineering or Personnel department with a 
salary between $10,000 and $20,000 OR 

2. in the Marketing department with a salary equal to or 
over $30,000 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
, LINE 


FIELD 


SELECTION CRITERIA 



>/0QM.^<^0QOO 




jL=j£uij(MS^km£^ 


"^LuxAJyCnyurfjfi 


^ J^a hAiJ^ 


i!2:2^|K„ 


Last Name 

Salary 

Department 


> 10000 & < 20000 
=> 30000 

= Engineering | = Personnel 
= Marketing 


Figure 6-1. Selection Criteria on More than One Line 


When you use multiple lines of selection criteria, the 
system reads each line independently. Remember that the 
system assumes an | between the lines, so any record that 
meets the selection criteria on any one line will be used 

Of course, if a record is selected because it meets the 
selection criteria on one line, the system does not 
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compare it to the selection criteria on the other 
line(s) . A record is not printed more than once even 
though it may meet the selection criteria on more than one 
line. 

As an example, if the records from the file were printed 
using the selection criteria shown in Figure 6-1, the 
list shown in Figure 6-2 would be the result. 


Name 

Department 

Salary 

Lorna A. Boyle 

Engineering 

16998 

Karen J. Benson 

Personnel 

12932 

Thomas W. Jackson 

Personnel 

12938 

Simon E. Swanson 

Engineering 

18890 

Robert M. Lopez 

Personnel 

13389 

Patricia H. Nelson 

Marketing 

3A829 

Mavis Y. Nelson 

Personnel 

10987 

Diane K. Preston 

Engineering 

18909 

Victor P. Fisher 

Marketing 

31839 

Theresa H. Black 

Personnel 

18938 

Simon E. Carrigan 

Personnel 

16589 


Figure 6-2. List Produced Using Multiple Lines of Selection Criteria 


SELECTING RECORDS BASED ON CRITERIA IN MORE THAN ONE FIELD 

So far you've learned about selecting records based on 
the values in one field of a record. To select a record 
based on the values in more than one field, you simply use 
the selection criteria for each field just as though you 
were qualifying only on that field. The system assumes an 
& between the fields on the same line in the record 
selection frame. 

If you were to use the selection criteria shown in 
Figure 6-3, the system would read it as select all 
records for a person in either the Engineering or 
Personnel department with a salary that is greater than 
$10,000 and less than $20,000. For a record to be 
selected, it must contain one of the two acceptable 
departments and a salary that is within the specified 
range. 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 


FIELD 



SELECTION CRITERIA 


A^ "^ 


>/i)0OO ^<JlO^W 


/ 


S*^i^.f9A4^r%a^ ^""^M^^mffimJ. 


Last Name 

Salary 

Department 


> 10000 & < 20000 

= Engineering 

= Personnel 


Figure 6-3. Sample Selection Criteria Used in More Than One Field 


Records for people in either the Engineering or Personnel 
department but with a salary less than $10,000 or more 
than $20,000 will not be selected. Records that contain a 
salary in the right range, but do not list the department 
as Engineering or Personnel will also not be selected. 

Remember that when you specify selection criteria for 
more than one field in a file, the system reads the 
selection criteria as though there were an & between the 
fields. Any record selected has to contain values 
matching the specified selection criteria for each field. 


USE OF IGNORE CHARACTERS IN THE SELECTION FUNCTION 

Ignore characters tell the system that you are specifying 
a comparison value for only part of the value in the 
field, and that you don't care about other, non-specified 
part of the value. There are two types of ignore 
characters . 

1. Each ignore character, tells the system to ignore one 
specific character in a field during a search. 
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Suppose your file has a combined field with a code for 
sex and a two digit number for age (for example, F26 
for a female, age 26). You can use an ignore character 
to tell the system to ignore the code for sex and look 
only at the two digit number for age. You can also 
use two ignore characters to tell the system to 
ignore the two digit number and look only at the code 
for sex. Figure 6-4 shows how an ignore character 
would look in a selection frame used to select only 24 
years olds regardless of sex. 


RECORD SELECTION SPECIFICATIONS 


SELECTION 

. LINE 

FIELD . 

SELECTION CRITERIA ; 

/ 

UDnJlnJUaC 
















.' ' " ", ^ ..■,,■.. . '.,. ' 


Last Name 

Salary 

Combined Field 



= • 24 


Figure 6-4. Selection Criteria With An Ignore Character 


2. An ignore rest (of-field) character tells the system 
to ignore any characters in the field that are to the 
right of the ignore rest character. This can be used 
when you want to compare the selection criteria to 
only the first part of a field. 

For example, if you wanted to select all the records 
that contained a last name beginning with K, your 
selection frame would look like Figure 6-5. 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

/ 

^(dJ^ y^^^mJL^ 

,, " A C^.-6«^nMjt-- y5/^,,™«/ 













„ ™„ . «,,,,_., 





Last Name 

Salary- 

Combined Field 

=K? 




Figure 6-5. Selection Criteria With Ignore Characters 


In the selection frame in Figure 6-5, you are telling 
the system that the only comparison value is a K at 
the beginning of the field. All other characters in 
the field are to be ignored. If you had used just 
"=K", the system would have selected records that 
contained only the letter K. 


WHEN CAN YOU USE THE SELECT FUNCTION? 


The select function can be used during the following 
procedures : 


revising or displaying records 

counting or deleting records 

duplicating selected records 

printing a file or storing it to diskette 

merging a file with text (letters, lists, reports) 
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REVIEW EXERCISES 


On the following page are copies of Record Selection 
Specifications and selection problems. Using the file 
information on the File Design Worksheet shown below fill 
in a set of Record Selection Specifications for each 
selection problem. 


FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE-'^ 


NUMBER OF 
CHARACTERS-' 


COMMENTS 


cyyr^jtffmjUs.yld>mju 


c/aA^ 


:i^ 


Cayjipo/nu 


^yio/mju 


Al^ 


LAOL- 


X6 



/S 


S\ 


yoAtz^j -Mx:ii^ oA^^juTyuii^lim^ 


- 7:<t A. 


A 


ytJ^Ji^ g^^;tf?^j!^z<a^^<:Mxt^vc^ 


fMuijt yiO/yriLt 


/O 


70^1 


:l 


.e.>ytc/u/)6u JQJA^»Ui7^U.Qj6i^^ 


C^dXLf^ ^^4t/yrtJU 


/6 


^fjl^i^ijt^ 


^ 


^«^c£oca6lj .j^xu/tte/ k/j^/.^p^ 


(^>tJ?!Zb6/ >9^ 


:^rt^ct^ 


JL 


/yrv6->i:iC/^ii^ JJcjug/' ca>c6st/>:/ 



&ytJ!!au!jf- -cJt 


f 


:l 


'Jaxit c^ryvtAc/ 


clgyOda/!:/' 


/ 


J^ 


£^J^^//t^^ 


& 




Sjj /fAoj /f^ /i/ 


cAl 


OA^ 


/^ 


J&^ 


^rtA/yrUL^ 



ye^r.:^, 



Uyrt<dtcu>6u 


yrVOC 


.^<;<U-^ Cdt/jU 


"'character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 
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1. Select all the records with orders less than $50,000 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 





























2. Select those customers with names beginning with K or 
S. (There is more than one selection method you can 
use. ) 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 
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3. Select all the records for customers from Arizona 

with orders that are equal to or more than $15,000 and 
equal to or less than $60,000. 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 
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REVIEW ANSWERS 


1. 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

/ 

AaCiA^ 

^ 50000 














2. 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 


FIELD 


SELECTION CRITERIA 


/ 




OR 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

/ 

Cud^SyKU) y$,r>u 

. >^ ^<L / >vf f^ <T 

















3. 


Both selection methods shown will work. In the first 
method you must put the selection criteria on 
separate lines, as shown. 

In the second method, it is necessary to establish a 
range. If you used =K, you would get only the records 
in which the customer's name was the letter K. 
Remember that an = sign requires an exact match 
between the value in the field and the comparison 
value. Using a range between the letter K and the 
letter L will give you all records in which the 
customer's name comes after K but before L. 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

/ 

sr 

=A2 

/ 

£ka6ui^ 

= >/SOt?0 / =<i,oooo 











Remember to put the selection criteria for both 
fields on one line because you are searching for 
records with customers from Arizona and with orders 
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between $15,000 and $60,000. If you put them on 
separate lines, you'll get the records for all 
customers from Arizona, regardless of size of order, 
as well as the records for all customers with orders 
between $15,000 and $60,000, regardless of location. 
If the selection criteria are on separate lines, the 
system reads an implied | between them. 
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CHAPTER SUMMARY 


The select function is to used choose specific 
records for use. 

Each selection specification must include: 

- a field name 

- a comparison criteria 

- a comparison value 

There are six comparison criteria: 

1. = (equals) 

2. 5^ (not equals) 

3. < (less than) 

4. > (greater than) 

5 . => (equal to or greater than) 

6. =< (equal to or less than) 

There are two logical criteria: 

1. & (AND) 

2. I (OR) 

You can have select criteria in more than one field. 
The selection criteria for the fields are linked with 
an implied & (AND). 

You can have up to 12 lines of selection criteria. 
The lines are linked with an implied | (OR). 

You can use an ignore character to tell the system 
that you don't care about the value in a specific 
character position in the field. There are two types 
of ignore characters : 

1. an ignore character covers one character position 

2. an ignore rest (of field) character covers all 
the characters to the right of the character you 
want to ignore 

The select function can be used during: 

- revising or displaying records 

- counting or deleting records 

- duplicating selected records 

- printing a file or storing it to diskette 

- merging a file with text (letters, lists, 
reports) 
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• The Record Selection Specifications worksheet is used 
in this chapter. 
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Sorting Records 


Whether you use all the records in a file or only selected 
ones, at times you may want to sort the records into some 
specific order. The sort function on the IBM 
Displaywriter System enables you to put records into 
order based on the values in the sort fields. 

The character sorting chart in Appendix B shows the exact 
sort order, but generally the system sorts the records in 
the following order: 

1. graphic characters, such as $, &, %, or a required 
space, first, 

2. then the letters of the alphabet, 

3 . then numbers 


HOW TO COMPLETE THE SORT SPECIFICATIONS 

The Sort Specifications are used with most of the 
worksheets that you will be using, such as the Report 
Design Worksheet (which is discussed in Chapter 11) . 
You'll use the Sort Specifications to specify what the 
sort fields are and whether the records should be sorted 
from low-to-high or high-to-low. The first field name 
listed is used for the first sort, the second field name 
is used for the second sort, and so on. 

You'll learn how to use the sort function in the following 
sections. Completed Sort Specifications are shown with 
each sample of a sorted list. 

USING THE SORT FUNCTION 

To use the sort function, you need to specify: 

• the field to be sorted on (the sort field) , and 

• whether the records should be placed in order from 
low-to-high (low numbers first) or high-to-low (high 
numbers first) . 

If the sort field contains alphabetic characters, 
low-to-high means A-Z and high-to-low means Z-A. 
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The system then places the records in order based on the 
the values in the sort field. The method the system uses 
to sort the record is described below. 

Suppose the sort field contains last names and the system 
is sorting the records from low-to-high. The system looks 
at the first character in each name, then the second 
character, and so on. When the system compares the names 
"Able" and "Abner,"for example, it sees that the first 
two characters are the same. It keeps comparing 
characters until it finds a difference. In this case, 
when the system checks the third character, it places 
Able before Abner because "l" comes before "n" in the 
alphabet. 

If the system checks all the characters in the sort field 
and cannot find any difference, records having the same 
values appear in the order in which they were added to the 
file. The first record added to the system would be placed 
before the second record added to the system, and so on. 


SORTING RECORDS USING MORE THAN ONE SORT FIELD 


You can sort records based on the values in up to five 
fields. Using the file shown in Figure 7-1, suppose that 
you want to put the records in order by name. You would 
use three sort fields: Last Name, First Name, and MI 
(middle initial). 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

^aajtf }^a^*itjeL. 

(low TO high)/ ■ HIGH TO LOW 

FIELD TO BE SORTED SECOND 

J^i?«j4<t€: y?<su*^%^ 

<1L0W TO high)/ high TO LOW 

FIELD TO BE SORTED THIRD 

MX 

(low TO high)/ high TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH /^HIGK TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / UGH TO LOW 
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Lambert, Stanley R. 

5483 ^^ ' ^^ ^~ • 

Lee, Cynthia R. 

2837 

Lopez, Robert M. 

3782 

Madison, Maxwell A. 

3956 

Martin, Jeff D. 

3856 

Morgan, Helen K. 

2583 

Nelson, Mavis Y. 

8293 

Nelson, Patricia H. 

5434 

Norton, Roger T. 

2837 

Ostrom, Gerald S. 

1726 

Ostrom, James R. 

3847 

Park, Trisha J. 

3948 

Perkins, Sherry J. 

3553 

Perry, Tracy S. 

2839 

Preston, Diane K. 

3894 

Rogers, Brian K. 

7462 

Schultz, Lisa G. 

5839 

Shaw, Pauline F. 

5840 

Smith, Walter A. 

5938 

Smith, Walter M. 

3874 

Steiniger, George J. 

8379 

Swanson, Simon E. 

5849 

Tweeden, Nancy W. 

8293 

Velasco, Marilyn L. 

4958 

Velasco, Michael L. 

2748 

White, Barbara N. 

5394 

White, Jack E. 

3868 

Wilson, Barbara J. 

2647 


Figure 7-1. Part of the Name and Telephone Extension List 


The system does a series of steps to sort the records. 

1. Since Last Name is the first sort field, the system 
organizes the records in order by last name. 

2. Then the system determines whether any records have 
the same last name. 

3. If a group of records all contain the same last name, 
as they do in the sample file, the system then 
organizes those records in order by first name. 

4. Finally, the system determines whether any records 
still have the same values (in this case, the same 
last name and first name). If any do, the system then 
organizes those records by middle initial. 

5. If any records have the same values for all the sort 
fields (in this case, the same last name, first name, 
and middle initial), the records with the same values 
are used in the order as they were entered in the 
file. So the first record that contains a name is 
displayed, printed, or duplicated first; the second 
record containing that name is used second; and so 
on. 
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When the sorting process is finished, the system has 
alphabetized the names, just as you would have done it by 
hand. 

If you are sorting on more than one field, remember that 
you can specify not only the sort fields but also the way 
each field is sorted (low-to-high or high-to-low). 

Suppose you are sorting a list like the one in Figure 7-2 
with the records sorted first by department, then by 
salary. You specify department as the first sort field 
and have it sorted low-to-high so that the departments 
are in alphabetical order. Within each department you 
want the salaries listed with the high salaries first, so 
you specify salary as the second sort field and have it 
sorted high-to-low. 


WHEN CAN YOU USE THE SORT FUNCTION? 


The sort function can be used during the following 
procedures : 

• printing a file or storing it to diskette 

• merging a file with text (letters, lists, reports) 

• duplicating selected records 

SORT SPECIFICATIONS 



FIELD NAME' 

KIND OF SORT 

FIELD TO BE SORTEB FIRST 

i^^aAJt^rUi.^i^ 

(low TO HIGiTy HIGH TO LOW 

FIELD TO BE SORTED SECOND 

/ 

LOW TO HIGH /^GH TO LOw) 

FIELD TO BE SORTED THIRD 

iT ■ 

LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Accounting 

$36,278.00 

Wilson 

Accounting 

$25 

298.00 

Madison 

Accounting 

$2A 

893.00 

Smith 

Accounting 

$22 

918.00 

Clark 

Accounting 

$22 

839.00 

Morgan 

Accounting 

$20 

387.00 

Fisher 

Accounting 

$20 

298.00 

Steiniger 

Accounting 

$18 

378.00 

Norton 

Accounting 

$16 

783.00 

Velasco 

Administration 

$36 

28-3.00 

Kramer 

Administration 

$18 

394.00 

Lambert 

Administration 

$14 

893.00 

Garcia 

Administration 

$14 

284.00 

Tweeden 

Administration 

$13 

495.00 

Rogers 

Administration 

$12 

827.00 

Boswell 

Administration 

$11 

892.00 

Kelly 

Administration 

$11 

456.00 

Perry 

Administration 

$10 

500.00 

Burns 

Engineering 

$38 

283.00 

Crawford 

Engineering 

$32 

938.00 

Hunt 

Engineering 

$27 

978.00 

Forrest 

Engineering 

$27 

898.00 

Acker 

Engineering 

$23 

890.00 

Davidson 

Engineering 

$20 

294.00 

Lee 

Engineering 

$18 

909.00 

Preston 

Engineering 

$18 

890.00 

Swanson 

Engineering 

$16 

998.00 

Boyle 

Marketing 

$34 

829.00 

Nelson 

Marketing 

$31 

839.00 

Fisher 

Marketing 

$29 

082.00 

Perkins 

Marketing 

$28 

382.00 

Knight 

Marketing 

$27 

892.00 

White 

Marketing 

$25 

998.00 

Ostrom 

Marketing 

$25 

849.00 

Kahn 

Marketing 

$25 

482.00 

Chapman 

Marketing 

$22 

098.00 

Goodman 

Personnel 

$25 

829.00 

Smith 

Personnel 

$23 

928.00 

Velasco 

Personnel 

$20 

283.00 

Anderson 

Personnel 

$18 

938.00 

Black 

Personnel 

$16 

589.00 

Carrigan 

Personnel 

$13 

389.00 

Lopez 

Personnel 

$12 

938.00 

Jackson 

Personnel 

$12 

932.00 

Benson 

Personnel 

$10 

987.00 

Nelson 

Planning 

$33 

587.00 

Shaw 

Planning 

$32 

893.00 

Bradley 

Planning 

$25 

677.00 

White 

Planning 

$24 

445.00 

Park 

Planning 

$20 

289.00 

Young 

Planning 

$20 

283.00 

Wilson 

Planning 

$17 

583.00 

Martin 

Planning 

$13 

283.00 

Ostrom 

Planning 

$12 

384.00 

Schultz 


Figure 7-2. Sample File Sorted by Department and Salary 
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REVIEW EXERCISES 


On the next page are copies of the Sort Specifications and 
sort problems. Using the file information from the File 
Design Sheet below and the Sort Order Chart in Appendix B, 
fill in the Sort Specifications for each sort problem. 

FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE- 


NUMBER OF 
CHARACTERS-' 


COMMENTS 


Cyj/i^t^MU^.y^d^rruj 


cAa/u 


:i^ 


jSL,^ 


£^^0^ 


x^ 


C^y?i43a/nc/ 


/O^LOymJLJ 



/s 


yoAtz^y -Mx^ju aJ/^iji/i^ccC^lirn^ 


:22z^ 


^ 


.^^tA, (f^CffyiJ&lG^ y:xiAy(yffyt^ 


fMud- y^O/rnxj 


/O 


>^I 


.^.yveAc/f^L^ ^aM^rt^C2^i^zi:^on^ 


(S^d^U ^^/O/yt'rjLj 


/5 


^uj UiJcA. 


.i/yic£eju/ij 


.^^lU/ttc:&^AAffyL^ 


(^yiJ6i ^>^ 


yrt^ut^ 


:l 


/yrtur>i:M^it^ J&xjq:/' CsyC^ajC^ 


6ryct»j'J^A 


f 


:l 


C&xif <UP^:tAc/ 


uryt^!^u^ 


f 


.2^ 


£^^A^JtA^ 




POgAa^ ^JUU 


cAaJu 


/^ 


A>ot. 


-i^ftA/JOtJ^ 




72e^ 


^^^tcAc^dz 


¥ 


. Mtu^ cen)C Lj_ 


"character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 
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1. Sort the records so that they are in alphabetical 
order by state and city. 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


2. Sort the records so that they are in order by sales 
respresentative with the records with the largest 
orders listed first. 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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3. Sort the records so that they are in order by date of 
contact with the most recent dates first. 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


l-\ 
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REVIEW ANSWERS 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

^t 

(low TO high)/ high to LOW 

FIELD TO BE SORTED SECOND 

^^ 

(LOW TO high)/ high TO LOW 

FIELD TO BE SORTED THIRD 

(f^ 

LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

.^^a^^ .^e/i^ 

(low to high)/ high TO LOW 

FIELD TO BE SORTED SECOND 

^Axp^^-t^ 

LOW TO high /(|HIGH TO LoiT) 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

Ca^TaxU^ ' ^ 

LOW TO HIGH /(high TO LOW) 

FIELD TO BE SORTED SECOND 

C^-&ax;^1^o 

LOW TO HIGH /(HIGH TO LO\J) 

FIELD TO BE SORTED THIRD 

CayrfoLcT I^Xa^ 

LOW TO HIGH /(HIGH 'to LOW) 

FIELD TO BE SORTED FOURTH 

(7 

LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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CHAPTER SUMMARY 


Sorting puts the records in alphabetic or numeric 
order. 

You can sort the records on one to five fields. 

You can specify for each field whether the sort is to 
be low-to-high or high-to-low (A-Z or Z-A) . 

The sort function can be used when: 

- printing a file or storing it to diskette 

- merging a file with text (letters, lists, 
reports) 

- duplicating selected records 

The Sort Specification worksheet is used in this 
chapter. 
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Math Instructions 


In the review exercises in Chapter 3, you marked a number 
of the variables as being the result of math 
calculations. In this chapter, you'll learn how to do 
math instructions, which are used to insert a math 
calculation into a shell document. 

For example, the system can do the following calculation: 

Annual Interest = Principal Amount x Interest Rate 

You may not know, as you create the shell document, what 
numbers will be used in the math calculation. However, 
you can use variable names to represent the numbers. In 
the calculation shown, the number represented by the 
variable "principal amount" will be multiplied by an 
"interest rate" to produce an "annual interest". When the 
document is merged with a file, the system uses actual 
numbers to calculate the answer. 

The three parts in a math calculation are marked in 
Figure 8-1 and are discussed below. 


Annual Interest = Principal Amount x Interest Rate 


Figure 8-1. Sample Math Calculation 


The answer to each calculation is represented by a 
variable name for answer, which we'll call an answer 
variable. 

The numbers actually used in the calculation are 
called the first number and second number. The first 
number and the second number may each represent one 
of three types of numbers: 

a. A field name for a math field in the file that 
will be merged with the shell document. In this 
case. Principal Amount may be a math field in a 
file. As each record is merged with the shell 
document that contains the math calculation, the 
number in the Principal Amount field in that file 
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is used in calculating the answer to the 
calculation. 

An answer variable representing the answer to a 
previous computation. For example, the Annual 
Interest could be used as a number in another 
math calculation, such as 


Balance = Annual Interest + Principal Amount 


c. A constant number. If a constant number is used, 
it must meet the same requirements as a number 
typed in a math field in a file. If a number, 
such as Interest Rate, will be the same in all 
calculations, it should be assigned as a constant 
number . 

El The calculation sign simply tells the system what type 
of math calculation to perform. There are four 
calculation signs: 

+ (add) 

- (subtract) 

" (multiply) 

/ (divide) 

Only one calculation sign can be used in each math 
calculation. 

Most math calculations resemble the one we just 
described. Each calculation has an answer variable, two 
numbers, and a calculation sign. However, another type 
of math calculation can be written. If you want to assign 
a number to a variable name, you can simply create a 
calculation that contains an answer variable and the 
first number, such as: 

Rate = .075 (for 7.5%) 


HOW TO COMPLETE THE MATH INSTRUCTIONS WORKSHEET 


Math instructions can be used with some of the worksheets 
that you'll be using, such as the Report Design Worksheet 
(discussed in Chapter 11). To fill out the Math 
Instructions Worksheet, you need to indicate the: 

• variable name for answer 

• first number 
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• calculation sign 

• second number 

You'll learn more about math calculations in the 
following sections. A completed Math Instructions 
Worksheet is shown with each example. 


Using More Than One Math Calculation 


The answer variable in a math calculation can be printed 
when the shell document is merged with a file and it also 
can be used as a number in another math calculation. For 
example, to calculate an employee bonus that equals 1% of 
the current salary for each year of service, you need to 
do a series of calculations. The Math Instructions 
Worksheet for this set of calculations is shown in 
Figure 8-2. 


MATH INSTRUCTIONS 


REF. 
NO.^'^ 

VARIABLE NAME 
FOR ANSWER--'^--'^ 


FIRST 
NUMBER'V-.'."V 

+ - -V . 

SECOND 
NUMBER'V*--'^ 

Ml 

■^£yOyLa> yCUAyo<^c<^ 

= 

// 

— - 

■HyC/le^ U^f^ 

M2 

-.^Oje^ce^^^ 

= 

-^:^ayi<P d/l^^^rceJl. 

^ 

'Of 

M3 

'^^^i-w^i^ 

= 

Id'^^T/Cgyy^ 

^ 

Da£^L/iy<^ 

M4 


= 

/ 


^ 

M5 


= 




M6 


= 




M7 






M8 


= 




M9 


= 





Figure 8-2. Sample Math Instructions Worksheet for Bonus Calculation 


Since there is no file information that specifically 
contains the number of years the employee has been 
with the company, we'll have to calculate the years 
of service for each employee. To do this we'll 
subtract the year the employee was hired from the 
current year. 

Next, to determine the bonus percentage, we'll 
multiply the years of service by .01 (1%). 

Finally, we'll multiply the employee's salary by the 
bonus percentage. 
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Notice that the method of calculating the bonus is 
exactly the same as it would be if you were doing it by 
hand or with a calculator. You could also use an 
alternative calculation method in which you calculate the 
years of service as we just did, multiply the employee's 
salary by .01 (1%), then multiply that number times the 
years of service. Either method will give you the same 
answer. 

There is no specific limit on the number of math 
calculations that can be used in a shell document, but you 
can use only 20 variable names for answers. In some 
cases, like one shown in Figure 8-3 in which the answer 
variable "total" is reused, the same answer variable may 
be reused in several calculations. 
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SUMMARY OF EMPLOYEE BONUSES BY DEPARTMENT 


Account 

ing 


Employee Name Salary Years Bonus 


Velasco 

$16,783.00 7 $1,174.81 


Norton 

$18,378.00 13 $2,389.14 


Steinig 

er $20,298.00 6 $1,217.88 


Fisher 

$20,387.00 3 $611.61 


Morgan 

$22,839.00 18 $4,111.02 


Clark 

$22,918.00 8 $1,833.44 


Smith 

$24,893.00 16 $3,982.88 


Madison 

$25,298.00 22 $5,565.56 


Wilson 

$36,278.00 14 $5,078.92 


Total D 

epartment Bonuses: $25,965.26 


Administration 


Employee Name Salary Years Bonus 


Burns 

$10,500.00 1 $105.00 


Perry 

$11,456.00 2 $229.12 


Kelly 

$11,892.00 8 $951.36 


Boswell 

$12,827.00 17 $2,180.59 


Rogers 

$13,495.00 .16 $2,159.20 


Tweeden 

$14,284.00 8 $1,142.72 


Garcia 

$14,893.00 9 $1,340.37 


Lambert 

$18,394.00 26 $4,782.44 


Kramer 

$36,283.00 17 $6,168.11 


^ Total Department Bonuses: $19,058.91 


/ Engineering 



Employe 




Boyle 




Swanson 

/Page Heading/ 



Preston 

SUMMARY OF EMPLOYEE BONUSES BY DEPARTMENT 



Lee 




Davidso 



\ Acker 

/Group Heading^Department/ 


\ Forrest 

l^^^^^^gll 


\ Hunt 

VDepartmentV 


\ Crawfor 



\ 

Employee Name Salary Years 

Bonus 

\ Total D 

/Record Detail/ 
/years service = 81 - Hire_Yr/ 
/percent = years service * .01/ 
*"""-*^.^_^_^ /bonus = percent * Salary/ 

vSsTTam^VSalar^lVVyears_service_j_2V Vbonus_^lV 




/Group Summary_jPepartment/ 




Total Department Bonuses: Vtotal_^lV 



Figure 8-3. Reusing the Answer Variable in a Math Calculation 
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PLACING MATH CALCULATIONS IN A SHELL DOCUMENT 


The math calculations are not printed when the shell 
document is merged with a file. The results of the 
calculations are stored in answer variables, and the 
answer variables can be inserted into the shell document 
text and printed. The math calculations do print if you 
are just printing a copy of the shell document, so that 
you can proofread them as a part of the shell document. 

For repetitive letters, you should usually type the math 
calculations at the top of the shell document before you 
type the text. In this way, the calculations are grouped 
together making it easier for you to check them. 
Figure 8-4 shows the shell document for a letter to an 
employee announcing the bonus calculated in Figure 8-2. 
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, '/years_service « 81 ~ nit&_Yti 
/percent » years^servtce *■ .01/^ ■■ \ ■„. .■ 
/.bonus =» percent * Salary/*' ' - >: ; .'*" ' . ' ■ - 



/,;" December ^15,. 1981' ■■. ,'./' V ^:!/'"'\. ■ j/ ':^ •-■' '■' -.'[■■■,■ '' ^ . , ' 



: .VTitleV VFirst_NameV VMIV Vtast_NameV/H Not Empty^^SubCitle/, VSubtitleV/End If/ 
'-■ -VStreet Address? ., ■ :,; • :: ,;'-■,, ""' 

■VCttyV.^VStateV VZip_Code¥ ■',,■,. ■ :\ " ' • 



Dear^ VTicleV VLast_NameV:;' -' \ , '•■ ■ 



■ this past year has been a banner year for us, and we would like to thank you, for your 
help in making it that, way. I*m pleased to announce that the Board of Directors has, 
voted to give each employee a bonus' of 1% of his or her salary for each year of 
service* ' ,..", \ --.." ''.'' ' " " ' •" ","•' "' .'. ■ ,- ' 



-Since you have been with us for ^years^sery±cej_3V ■ years , your bonus is $Vbonus,lV. 
This amount will be added to your next paycheck. 



Again, I'd like to thank you for your help and congratulate you on a fine year. 



Sincerely, 



. - Dan P. Andrews . 
-, ■ President "- " - 

December 15, 1981 

Mrs. Lorna A. Boyle 
122 North 10th Street 
Dallas, TX 71283 

Dear Mrs. Boyle: 




This past year has been a banner year for us, and we would like to thank you for 
help in making it that way. I'm pleased to announce that the Board of Directors 
voted to give each employee a bonus of 1% of his or her salary for each year of 

your 
has 


service. 




Since you have been with us for 6 years, your bonus is $1,019.88. Th 
added to your next paycheck. 

is amount will be 


Again, I'd like to thank you for your help and congratulate you on a 

Eine year. 



Sincerely, 




Dan P. Andrews 
President 




Figure 8-4. Sample Repetitive Letter With Math Calculations 
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In reports, the placement of the math calculations 
depends on what part of the information in the report is 
being used for the math calculations. Figure 8-3 is an 
example of a report containing math calculations. In 
Chapter 11. Reports, we'll talk more about the parts of 
the report and the placement of math calculations in a 
report . 


Using An Answer Variable to Create a Running Total 


In reports and repetitive letters, the numbers in an 
answer variable are replaced each time a calculation (or 
set of calculations) for a record is performed; 
otherwise, the results would be cumulative. When the 
bonus for employees is calculated, for example, the bonus 
is calculated using the information in each employee's 
record. The numbers in the answer variables for one 
employee are replaced by new numbers as the system 
calculates the bonus for the next employee. 

If you want to calculate the total results of a series of 
math calculations, you need to create a running total. A 
running total is an answer variable used to accumulate 
the results of a series of math calculations. Figure 8-5 
shows the format of a running total and how it could be 
used to calculate the total amount of bonuses payed in our 
previous example to employees. 


Running Total = Running Total + Answer Variable Being Accumulated 


MATH INSTRUCTIONS 


REF. 
NO.'V 

VARIABLE NAME 
FOR ANSWER--V* 


FIRST 
NUMBER'^--'^-^ 

+ - ,v - 

SECOND 
NUMBER--"''^* 

Ml 

7^^ 

= 

^ 



M2 

^^^M JjE/ij6^i^ 

= 

f/ 

— 

^/i^ <^. 

M3 

^M^:^^ 

= 

u^a/idSC24H^ 

■¥r 

,0/ 

M4 

A^^^ZUd. 

= 

pit<2je^^ 

-^ 

d>tiiJaAiA 

M5 

t^TiiZ 

= 

't^^^ 

7^ 

A>-nu<i^ 

M6 


= 




M7 


= 




M8 


= 





Figure 8-5. Sample Math Instructions Worksheet With a 
Running Total 


Notice that after each calculation, the number in the 
answer variable "bonus" is added to the answer variable 
"total." Then the bonus for the next employee is 
calculated. That number replaces the previous number in 
the answer variable "bonus". After all the bonuses have 
been calculated, the answer variable "total" contains the 
to total amount of all bonuses paid. 

You can set up a calculation that figures a running total 
in a report. For example, in Figure 8-3 as each bonus is 
calculated, it is added to a total to be printed at the 
end of the group. (In a report, there are groups of 
records. Chapter 11 contains a complete explanation of 
report groups . ) 

There must be a math instruction to set the running total 
to zero at beginning of each group; otherwise, the 
running total would reflect the total of all the bonuses 
calculated up to that point and would become a report 
total, not a group total. 

However, if you are calculating a running total for the 
entire report, there must be a math instruction to set the 
answer variable for the running total to zero at the 
beginning of the report. (See Chapter 11 for more 
explanation. ) 


WHERE CAN YOU USE MATH CALCULATIONS? 


You can use math calculations in repetitive letters and 
reports. You cannot use math calculation in a 
multi-column list like the ones shown in Chapter 11. 
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REVIEW QUESTIONS 


On the following page are copies of the Math Instructions 
worksheets and math problems. Using the field names 
listed on the File Design Worksheet shown below, fill in a 
set of Math Instructions for each math problem. 


FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE'^ 


NUMBER OF 
CHARACTERS'' 


COMMENTS 


Cyy/Dt^mjUs ^ y^/lrruj 


t/a/u 


j^^ 


C^yftp^f^yft^ 


/yt A^rnLJ 


AiCal 


LO^LL 


X6 



/S 


J". 


Xis^a^jy 'M<1JU> /M^jjlyt^Ulturn^ 


7;^ 


.6JtA, (r^c/ryi;6ic^ .^:iMAj04r>^^ 


fA/:ot >^amf-> 


/O 


>rll 


.<t»tci^^^>< ^y < ^t<^»<^2Z^ < <iZ<tf >t^ 


o^dAiJ^ ^(a/yytxj 


/5 


oJul^f^iJtA. 


i^jyv^^Adf >7^ 


:rzt^Ci^ 


X 


4^rtc£(A^ - pu/l'ti: ;CujOitl ^^ 


/Tj'Unii^tA^a^ ^MajQ:^' Ce>tst&/i/ 


&yu&af-<Jt. 


^ 


:l 


^.Axd (Uryctibt/^ 


CigyvdoLc/' 


f 


.^ 


£^^A6tA^ 




SO^Aoy /fyu 


cAoAj 


/•5 


Ja^ 


yy%ATf%A^ 



/^^ r.yz, 



.,<'7vdUco^ 


•»*^ 


. M'^^ 




tAl^^iOyX-^ 


-character field 
math field 
text field 


■•* 1-80 characters 
1-17 characters 
1-500 characters 
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Each sales representative is given a 10% commission 
on sales. Calculate the commission to be paid for 
each order. 


MATH INSTRUCTIONS 


REF. 
NO . * 

VARIABLE NAME 
FOR ANSWER--'^--'' 


FIRST 
NUMBER''"-'"-'' 

+ - -,v - 

SECOND 
NUMBER-''^""' 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 





The company's profit is the difference after the 10% 
commission is deducted from the order amount. 
Calculate the profit on each order. 


MATH INSTRUCTIONS 


REF. 
NO.--'' 

VARIABLE NAME 
FOR ANSWER--''--'' 


FIRST 
NUMBER--''--'"'' 

+ - -,'.- - 

SECOND 
NUMBER--'""'--'' 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 





3. Finally, calculate the company's total profits from 
all orders. (Hint: This requires a running total.) 


MATH INSTRUCTIONS 


REF. 
NO.''' 

VARIABLE NAME 
FOR ANSWER--'"'' 


FIRST 

NUMBER-'"'"'' 

+ . -V - 

SECOND 
NUMBER''"'"'' 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 
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REVIEW ANSWERS 


1. 


MATH INSTRUCTIONS 


REF. 
NO.'"^ 

VARIABLE NAME 
FOR ANSWER--"'--'' 


FIRST 
NUMBER'''''"-'' 

+ . Vr - 

SECOND 
NUMBER--'"''* 

Ml 

Co-orx.^yxU^X'^yLa'n^ 

= 

tyi^otz/ty' 

¥r 

JO 

M2 


= 




M3 


= 




M4 


= 




M5 


= 





MATH INSTRUCTIONS 


REF. 
NO . ■-'' 

VARIABLE NAME 
FOR ANSWER--'""' 


FIRST 
NUMBER*'"'--"' 

+ . -V . 

SECOND 
NUMBER--"'** 

Ml 

C,&yrtyy,'t/t^0.4>C<ryx^ 

= 

($^i^:!/a/i^ 

7^ 

JO 

M2 

4i>AolJt 

= 

£(^±/U*^^^ 

— 

Cor79'U*»%^ca.4,4^'n<^ 

M3 

/ cr^ 

= 




M4 


= 




M5 


= 





3. 




MATH INSTRUCTIONS 


REF. 
NO.* 

VARIABLE NAME 
FOR ANSWER** 


FIRST 
NUMBER*** 

+ . ■:■ . 

SECOND 
NUMBER*** 

Ml 

z^^k^x^i^ 

= 

^ 



M2 
M3 

^^af;^^<>Jm^/^>^t^ 

= 

(^^Z)^ 

-¥r 

JO 

/^^^p^^ 

= 

^%^z^ 

— 

/!^}f^i/m/.^u^t^^ 

M4 

^^^^^^^^ 

= 

1^2k^/2^j!X^ 

/ 

/^^^4^ 

M5 

r r^ 

= 



/ 6^ 


The running total, Total Profit, is necessary to 
accumulate the amount of profit calculated on each 


Math Instructions 


>-13 


order. Remember, the answer variable, Profit, is 
reset to zero for each order. 

You could also have calculated the company's total 
profits using the series of calculations shown below. 
The results are the same. This method is more 
complicated and requires two sets of running totals. 
It does, however, give you more specific information. 
From this method you can identify not only the 
company's total profits, but also the total sales 
orders and total commissions paid. 


MATH INSTRUCTIONS 


REF. 
NO.'"' 

VARIABLE NAME 
FOR ANSWER--'^--'^ 


FIRST 

NUMBER''^-^-'- 

+ - -.V - 

SECOND 
NUMBER--'''''--'^ 

Ml 

ibLaZ cnd£/iy' 

= 

^ 



M2 

ic)ti£ ^^<>>i'i/wU^^an 

= 

a 



M3 

■7ip7!a/ ^ri^'^i^a^ 

= 

T^fTa/i^^!^ 

-r 

^ri^p^e^^ 

M4 

C^^^,^id^ti>^fy 

= 

.?^%;€^ 

^ 

Jo 

M5 

^^^/6yfPfyM^/^rh 

= 

i^7a^da^^i*3^^^ 

> -^ 

C9t?1/^r}i4A'^zrn' 

M6 

p/iAi;^6y^ 

= 

Ti^aJ^^^)^ 


iota/ Ccma^^£(yr^ 

M7 

^ u 
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CHAPTER SUMMARY 


Each math equation can have four parts: 

1. a variable name for answer (answer variable) 

2. a first number 

3. a calculation sign 

4. a second number 

The first number and second number can be: 

- a field name 

- an answer variable from a previous math 
calculation 

- a constant number 

You can have up to 20 answer variables in a repetitive 
letter or report. Since an answer variable can be 
reused, you could have more than 20 calculations. 

Place math calculations at the top of a repetitive 

letter. 

Place math calculations at the point where they are 
to be used in a report. 

Math calculations can be used in repetitive letters 
and reports. They cannot be used in multi-column 
lists . 

The Math Instructions section of a worksheet is used 
in this Chapter. 
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Storing Math Formats And File Setups 


This chapter contains information about: 

• storing math formats that determine how a number is 
printed 

• storing setups that contain such information as 
selection criteria and sort fields for frequently 
used documents 


USING MATH FORMATS 


When you print a number you need to be able to print that 
number in the correct format. When printing a number from 
a field that represents dollars, for example, you want 
the number to print with a $ in front of it. If an answer 
variable represents years with the company, there should 
be no $ in front of it and no fractional numbers (such as 
"9.534 years of service"). The stored math formats are 
used to format numbers, whether the number is a field 
entry from the file or an answer variable. 

There are five math formats, numbered 0-4, on your IBM 
Displaywriter . You create Formats 1-4 to match your file 
use. Each format can be different. (Formats is a 
system format that you cannot change. It is explained 
later in this chapter.) 

Figure 9-1 shows a sample Math Formats Worksheet for 
Formats 1-4. The choices are explained in the following 
section. 


What Are the Math Formats Choices? 


Each of the following items describes the choices on the 
Math Formats Worksheet. For each item, you'll find: 

• an explanation of the item, 

• a list of the choices, and 

• the system default (what the system assumes if you 
don't specify anything). They are different for each 
format and are indicated by the shaded areas on the 
Math Formats Worksheet . 

If you choose to use a choice other than the system 
default, circle your new choice on the Math Formats 
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MATH FORMATS WORKSHEET 


ITEM 

FORMAT 1 

FORMAT 2 

FORMAT 3 

FORMAT 4 

Character for 
Decimal 

peri<id 

comma 
colon 

comma 
colon 

period 

comma 
colon 

p«£it>d 

comma 
colon 

Character for 

Thousands 

Separator 

period 

req. space 
none 

period 

req. space 
none 

period 

req. space 
none 

period 
comma 
req. space 

Number of 
Characters to 
Right of Decimal 

0-15 

0-15 

2' 

0-15 
_ 

0-15 

1;; _ 

Rounding Rule 

1-54-, 6-9t 
l-9i 
l-9t 
none 

l«44.,:5-9f:; 
1-54, 6-9t 
l-9i 
l-9t 
none 

1-54., 6-9t 
1-94. 
l-9t 
none 

1-54., e-gt- 

1-94. 
l-9t 
none 


Text (any eight characters) 


Your Notes 


"Example uses the positive number 25 
""Add $ in text 
"""Grade Point Average 


Figure 9-1. Sample Math Formats Worksheet 


Preceding 
Positive Number 
or Zero 

:iio'ltekt: 

f 

:n«i>'v;t:'$xt: 

'li{>'':'t«iXt' 

Following 
Positive Number 
or Zero 

rnov;|ext.. 

ijO::tejtt 

^o t&xt 

■ii<y',;::tei!:t; 

Preceding 
Negative Number 

- (minus) 

-$: 

.~ (minus) 

- (minus) 

Following 
Negative Number 

■iio:;?text::;: 

,nii::;'t'eXt'; 

^iio'"''t'axt;i 

lisiliii; 


Example of 
This Format" 

i^iM; 

m^:m< 

2S 

:2S'V^; 

This Format 
Used For 

moiiay^* 

moiii^y. 

'y<*K'?8' 

"^M^: 
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Worksheet (or write in your choice for number of 
characters to the right of the decimal point) 

Refer to Figure 9-1 as you read this section for the 
complete list of choices. 

1. What character is used as a decimal point (the 
character used in a fractional number, such as 7.25). 

The choices are a period, a comma, or a colon. 

2. What character is used as a thousands separator (the 
character used to break 100000 into 100,000, for 
example) . 

The choices are a period, a comma, a space, or none 
(no separation between thousands) . 

3. How many numbers are allowed to the right of the 
decimal point. For example, if the answer to an math 
calculation is 44.787, should it be printed as 44, 
44.7, 44.78, or 44.787? 

The choice is any number of digits from (no decimal 
point is printed) to 15 digits to the right of the 
decimal point. 

4. How a fractional number should be rounded if there 
are more characters to the right of the decimal point 
than you want. For example, should 9.445 be round 
down to 9.44 or up to 9.45? 

The rounding choices: 

1-4 down, 5-9 up 

1-5 down, 6-9 up 

1-9 down 

1-9 up 

do not round the number (stop after the permitted 

number of characters . 

Whether text that you specify is to be printed 
automatically: 

a. in front of a positive number or zero. For 
example, should a $ or + print before each 
positive number or zero? 

The choices are any eight characters or print 
nothing. 

b. after a positive number or zero. For example, 
should a ) or the word CREDIT print after each 
positive number or zero? 
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The choices are any eight characters or print 
nothing. 

c. before a negative number. For example, should a 
-$ or - print before each negative number? 

The choices are any eight characters or print 
nothing. 

d. after a negative number. For example, should a ) 
or the word DEBIT print after each negative 
number? 

The choices are any eight characters or print 
nothing. 


When Is Each Math Formats Used? 


V/hen a number is printed, either from a math field or as a 
result of an math calculation, it is formatted according 
to the math format specified with the variable name. In 
Figure 9-2 the same number is printed using each of the 
four math formats shown in Figure 9-1. Notice how the 
number is formatted differently. 

The number that follows the variable name is the number of 
the Math Formats to be used when the variable is printed. 
For example, VSalary,2V means the variable "Salary" is to 
be printed using Math Format 2. If there is no number 
following the variable name, Format is used and the 
number prints as it was keyed. 


::;:■> Format ; 

,:;■ ¥Saiary¥ (as .keyed) 

' :': ^ Format 1 

■; :'j ¥Salar3^iy ■ 

.^;--;.-, : Format 2 

: .;:¥Salary:^2¥:V:,^ ■;::■::. ■: 

::;:.;'; Format 3.; 

V^.ySalary^):;-r/;: 

■^; ;':>:; 4^: Format -4: : 

%-:vSBlary^:---yf^ ■ 


Format 

13495 

(as keyed) 

Format 1 

13,495.00 


Format 2 

$13,495.00 


Format 3 

13,495 


Format A 

13495.0 



Figure 9-2. Number Formatted Using Different Math Formats 


If no math format is specified, the default format 
depends on the origin of the number. If the number is a 
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field entry from the file, the system defaults to Format 
which prints the number exactly as it was typed in the 
file. If the number is an answer variable, the system 
defaults to Format 1, unless you have specified another 
format as the active default format. 


Completing the Math Formats Worksheet 


Use the Math Formats Worksheet in Appendix A to create the 
four math formats that you will be using. These format 
can be changed later if necessary. 


USING STORED FILE SETUPS 


If you have repetitive letters or reports, such as 
monthly salary reports, that are done regularly, you can 
keep your worksheets or remake the decisions about 
sorting and selecting each month. However, it can be more 
convenient to store this information in a stored file 
setup. 

File setups can be stored for: 

• record selection 

• sorting records 

• outputting a file (either printing it or storing it 
to diskette) 

• merging a file with text 

• duplicating selected records 


How Stored File Setups Are Organized 


A file setup stores the choices that you made in various 
frames or menus. The frame displayed at the time you 
stored the setup determines which frame (s) is (are) 
stored. The frame displayed at the time you recall the 
setup for use determines which frames are recalled. The 
chart in Figure 9-3 shows the relationship between the 
frame on the display and the frames that are stored or 
recalled. 
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FRAME ON THE DISPLAY FRAMES STORED OR RECALLED 

Record Selection 

Record Selection 

Sort 

Sort 

Output File 

Record iSelection 

Sort 

Output File 

Merge File/Text 

Record Seliection 

Sort 

Merge File/Text 

Duplicate Selected Records 

Record Selection 

Sort 

Duplicate Selected Records 


Figure 9-3. File Setup Organization 


There are three higher level frames: Output File, Merge 
File/Text, and Duplicate Selected Records. When a setup 
is stored in a higher level frame, the sort and selection 
frames are also stored. When you recall a stored file 
setup and you have one of the higher level frames 
displayed, all the frames listed for that higher level 
frame in Figure 9-3 are recalled. 

When a setup is stored While one of the two lower level 
frames (Record Selection and Sort) is displayed, only 
that frame is stored. 

When you are in a higher level frame and recall a setup 
stored in a different higher level frame, only the low 
level frames are recalled. As an example, when you are in 
an Output File frame and you recall a setup that was 
orignally stored in Merge File/Text, only the Record 
Selection arid Sort frames are recalled. The higher level 
frame. Merge File/Text, is not recalled. 


Advantages of Using Stored File Setups 

Using stored setups has two advantages: 


It is convenient to store your selection criteria and 
sort fields for the applications you use regularly, 
so that you don't have to recreate the setup each 
time. 
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2. It is helpful to store your setups when you are 

initially creating and testing your files and shell 
documents. If a problem occurs, you can recall the 
stored setup and verify that the information was 
entered correctly. 
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REVIEW QUESTIONS 


Fill in the Math Formats Worksheet on the next page so 
that numbers will print in the following formats: 

Format 1. 25 

Format 2. CR+ 75.99 or DB- 75.99 

Format 3. 83,283927 

Format 4. $2.34 or -$2.34 
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MATH FORMATS WORKSHEET 


ITEM 

FORMAT 1 

FORMAT 2 

FORMAT 3 

FORMAT 4 

Character for 
Decimal 

comma 
colon 

comma 
colon 

comma 
colon 

comma 
colon 

Character for 

Thousands 

Separator 

period 

req. space 
none 

period 

req. space 
none 

period 

req. space 
none 

period 
comma 

req. space 
none 

Number of 
Characters to 
Right of Decimal 

0-15 
2 _ 

0-15 
2 

0-15 
_ 

0-15 

i _ 

Rounding Rule 

i-U, 5-9t 

1-54., 6-9t 
1-94- 
l-9t 
none 

l-5i, 6-9T 
1-94. 
l-9t 
none 

1-5J., 6-9T 
1-94. 
l-9t 
none 

1-54., 6-9T^ 
1-94. 
l-9t 
none 


Text (any eight characters) 


Preceding 
Positive Number 
or Zero 

no text 

f:' 

n&[ text 

no text 

Following 
Positive Number 
or Zero 

no text 

no text 

^o text 

no. "text; 

Preceding 
Negative Number 

- (minus) 

-$ 

~ (minus) 

- (minus) 

Following 
Negative Number 

jKO'text 

no" "t ejifc: 

no;,;.;.tiB3tt'^; 

'lio'-teiSct::: 


Your Notes 


Example of 
This Format" 

'^^^XOQ:: 

$2$vO0 

IS 

25.0 

This Format 
Used For 

money** 

tttoney 

.:y^S??8' 

GI>A**C 


Example uses the positive number 25 
""Add $ in text 
""Grade Point Average 
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REVIEW ANSWERS 


MATH FORMATS WORKSHEET 


ITEM 

FORMAT 1 

FORMAT 2 

FORMAT 3 

FORMAT 4 

Character for 
Decimal 

comma 
colon 

comma 
colon 

■|(||it||:^ 

comma 
colon 

period 

comma 
colon 

Character for 

Thousands 

Separator 

period -^ 

req. space 
^none 

period "X" 

req. space 
none 

period -^ 
c<8oms 
req. space 
none 

per-^iod -^ 

comma 

req. space 

Number of 
Characters to 
Right of Decimal 

0-15 

2 

0-15 ¥r 

z 

0-15 

01 i 

0-15 

Rounding Rule 

IHn^. 5-9t 

1-5n1., 6-9t 

1-9nI. 

l-9t ^ 

none 

i-U, 5-9t 
1-54., 6-9t 
1-94. 

i-9r ^ 
none 

1-54., 6-9t 
1-94. 

i-gr i(r 

none 

1-A4., 5-9 1 

1-54., 6-9r 

1-94. 

l-9t ^ 

none 



Text ( 

any eight characters) 


Preceding 
Positive Number 
or Zero 


CR + 



Following 
Positive Number 
or Zero 

jtito^^Xt;' ^ 

i^SiiBsp:, ^ 


no tejct 

Preceding 
Negative Number 

r (minus) 

OS - 

~ (minus) 

- (minus) 

Following 
Negative Number 

;io:'''i«i!it;l' -iCr 

:j«>Stii^P -^^ 

no t«xt '^ 



Your Notes 


Example of 
This Format" 

25,00 

'mmQ; 

m 

'^51^ 

This Format 
Used For 

money** 

.mbiie-ji^i 

iiiilll 

SIS 


^Example uses the positive number 25 
"■•'•Add $ in text 
"""Grade Point Average 


Note: An asterisk marks those items whose choice does not 
affect the format shown. For example, the choice of 
rounding rule does not affect how the examples were 
formatted. In those cases, we simply used the system 
default. 
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CHAPTER SUMMARY 


Math formats are used to format information from math 
fields and answer variables. 

The math format allows the following choices: 

— the character for a decimal point 

— the character for a thousands separator 

— number of digits to the right of the decimal 
point 

— the rounding rule for fractional numbers 

— eight characters of text to precede and eight 
characters of text to follow a positive number or 
zero 

— eight characters of text to precede and eight 
characters of text to follow a negative number 

If no math format is specified, file entries are 
printed as they appear in the file. Answer variables 
print according to machine defaults. 

The Math Formats Worksheet is used in this chapter. 

Stored file setups are used to store the choices made 
in certain frames . 

The frames that can be stored are: 

— record selection 

— sort 

— output file 

— merge file/text 

— duplicate selected records 
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Repetitive Letters 


Repetitive letters are form letters that are personalized 
by including information from the file. (Although the 
term "repetitive letters" is used, any document 
containing constant text into which variables are 
inserted is handled the same way. Documents such as wills 
and standard contracts are included in this category.) 

Repetitive letters are produced by merging records from a 
file with a shell document. One output document will be 
produced for each record. (If you need to print letters 
that contain information from more than one record, see 
Chapter 12, "Reports That Look Like Letters.") 


CREATING THE SHELL DOCUMENT 


The shell document is a text document. All formatting 
information is included in it. The constant text, the 
text that is the same in every letter, is typed just as 
though the shell document was a regular letter. At each 
point in the shell document where variable information is 
to be inserted, the operator uses a Variable key to tell 
the system that the information is variable. 

The variable information can be: 

• information from a field in the file, specified by 
using the field name or number 

• an answer variable from a math calculation, specified 
by using the answer variable name 

If the information is a number from a math field or an 
answer variable, the math format is specified along with 
the field name or answer variable. Remember the Math 
Format is identified by the number following the 
variable. 

Figure 10-1 shows a sample shell for a repetitive letter. 
Notice the following items: 

D Math calculations appear at the top of the letter. 
These print when the shell document is printed so 
that they can be proofread, but they will not print 
when the shell is merged with a file. 

Q The answer variables from the math calculations will 
be printed in the letter. The number following the 
answer variable name is the Math Format number. 
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The entry from a field can be printed. Again, if the 
field is a math field, the number following it is Math 
Format number. 

Conditional text can be printed. Notice that for the 
first name of the spouse to be printed in the 
conditional text, it must be included as a variable 
in the conditional text as well as being used as the 
conditional text field. 


/service__)'ears = 
/insurance = , 15 


!1 - Hire_Yr/ 
• Salary/ 


November 1, 1981 


¥Title¥ VFirstJNameV ¥MIV VLast_NatneV/If Not Empty_jSubtitle/, VSubtitleV/jEnd If/ 

VStreet_AddressV 

VCityV, VStateV V2ip__CodeV 

Dear VTitleV ¥Last_NaTneV: ; 

As you may know, we've always tried to reward loyalty and service from our 
employees. The latest step in that direction is our new life insurance plan. 
For those employees who have been with us for more than 10 years, we are 
providing a life insurance plan that equals 15% of his or her annual salary. 
There is absolutely no cost to the employee. 


Our records show tha t ; yp" hairo Koor, TY^^v, ....n f ^^ «oa^^,-r^o^>a^3yo^'tu years and 

~rtt*fe~jmiirannual salary is $VSalaryj^lV. < ^ ' Thio mcana ' that- your life inauyanee 

policy wiir'par5:^$Vinsurancej_lV in the unfortunate event of your death. 

/If Not Emptyj_FN___Spouse/At present, we are listing your spouse, 
VFN_SpouseV ¥Last_NaffieV, as your beneficiary. Please let us know if this is 
not satisfactory. You are, of course, free to choose someone else as your 
beneficiary ./End If//If Empty_2FN__Spouse/At present, we have not designated a 
beneficiary for you. Please let us know as soon as possible who your 
beneficiary will be. /End If/ 


B 


If you have any questions,- please -call the Personnel office, 
to assist you in any way possible.. 

Sincerely, ;, • 


They will be happy 


Dan P. Andrews 
President 
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November 1, 1981 


Mr. Brian K. Rogers 
345 West 6th Street 
Dallas, TX 71098 

Dear Mr. Rogers: 

As you may know, we've always tried to reward loyalty and service from 
our employees. The latest step in that direction is our new life 
insurance plan. For those employees who have been with us for more than 
10 years, we are providing a life insurance plan that equals 15% of his 
or her annual salary. There is absolutely no cost to the employee. 


Our records show th^*" v"" h^-''° v.nr.n TT^•^Vl im <;.yV iA years and that your 
-€wmual salary is $13,495.00. <CThia meano that your lifo inouranco policy 
willpS^ $2,024.25 in the unfortunate event of your death. 


At present, we are listing your spouse, Jane Rogers,* 
beneficiary. Please let us know if this is not satisfactory, 
of course, free to choose someone else as your beneficiary. 

If you have any questions, please call the Personnel office, 
be happy to assist you in any way possible. 

Sincerely, 


Dan P. Andrews 
President 


You are. 


They will 


Figure 10-1. Sample Shell and Repetitive Letter 
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When the shell document is merged with the file, the 
system collects and inserts the variable information into 
the shell document to produce the final document. 
Remember, the system cannot print part of a field. All 
the information in a field named in a shell document is 
printed in the output document. 

As the system inserts the variable information into the 
shell document, it checks whether the variable 
information fits in the space occupied by the variable 
information entry in the shell document. If it won't, 
then the system adjusts the the text in the shell document 
so that the variable information fits without running off 
the page. 

You can tell the system not to adjust the lines, but then 
the output document may not print properly. However, the 
system should not be allowed to adjust lines if forms are 
being filled in, since printing the information on a form 
requires exact placement. 

ADDITIONAL FUNCTIONS YOU CAN USE WITH REPETITIVE LETTERS 

You can use some of the functions already discussed with 
repetitive letters. You can use: 

• conditional text instructions 

• select records for merging 

• sort records to print your output in a certain order 

• math instructions 
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REVIEW QUESTIONS 


You are to send a short letter to all Arizona customers 
notifying them that they will receive a rebate equal to 1% 
of their order. Indicate the amount of each order and 
rebate. If there is no name in the contact field, have 
the salutation read "Gentlemen". 

Use the conditional text section, the Record Selection 
Specifications worksheet, and the Math Instructions 
worksheet below. Then write the letter on the next page. 
Indicate the variables by use a V and the instructions by 
using a / . 


1. If 


2. is 
empty) 


(empty/not 


3. print 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

















MATH INSTRUCTIONS 


REF. 
NO.-^ 

VARIABLE NAME 
FOR ANSWER-'^^'' 


FIRST 
NUMBER"-""" 

+ _ -V . 

SECOND 
NUMBER-'^'^* 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 
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REVIEW ANSWERS 


1. If Contact 

2 . is empty 

3. print "Gentlemen" 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

1 

sr 

= A2 














MATH INSTRUCTIONS 


REF. 
NO.'- 

VARIABLE NAME 
FOR ANSWER''=-'V 


FIRST 
NUMBER''^--'^''^ 

+ - -sV - 

SECOND 
NUMBER--'^'^'^ 

Ml 

yl&^^t^ 

= 

£u;^ 

-Xr 

.0/ 

M2 


= 




M3 


= 




M4 


= 




M5 


= 
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/rebate = Order * .01/ 


December 15, 1981 

VTitleV VFirst_NameV VMIV VLast_NameV/lf Not Empty^Subtitle/, VSubtitleV/End If/ 

VCustomer_NamcV 

VAddressV 

VCityV, VSTV VZipV 

Dear /If Not Empty_j_Last_Name/VTitleV VLast_NameV/End If//If Empty_^Last_Name/Gentlemen_/End If/: 

We would like to let you know how much we value your business. To do this, we 

would like to to send a rebate of 1% of your total order placed with us. Since 

your order in 1981 totaled V0rder_^2V, the rebate we are sending your amounts to Vrebate_^2V. 

If there is anything that we can do for you, please let your representative, VRep_TitleV VSales_RepV, 
know. 

Sincerely, 


Dan P. Andrews 
President 


Your business letter may be slightly different. Be sure, 
however, that you included and marked all the variable 
information. 
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CHAPTER SUMMARY 


A repetitive letter produces one output document per 
record. 

Variables inserted into the shell document can be: 

- field names or numbers 

- answer variables 

If the variable information inserted is longer than 
the space occupied by the variable name in the shell 
document, it is adjusted to fit within the letter 
margins . 

Additional functions that can be used with repetitive 
letters are: 

- conditional text instructions 

- select records for merging 

- sort records to print your output in a certain 
order 

- math calculations 
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Reports 


A report is a list of information with a format that 
groups the information into meaningful units. Reports are 
produced by merging a shell document with a file. The 
output document produced contains the information from 
all the selected records in the file. 


WHAT DOES A REPORT LOOK LIKE? 


A report has six possible parts. These parts are shown in 
Figure 11-1 and explained in detail in "Building a 
Report" in the following section. 

D The report preface contains text and instructions to 
be printed once at the beginning of the report. The 
report preface may be simply a heading or it may be 
several pages in length. 

Q The page heading is used to specify text to be 

printed after the report preface and at the top of 
each subsequent page up to the report summary. A page 
heading is similar to the header used with regular 
text, but it can be viewed on the display with the 
other parts of the report. 

El A record group definition is used to define a group of 
record. It can contain text to be printed at the 
beginning of each group of records. You can use up to 
three record group definitions in a report. 

D Record detail causes the information from each 

selected record to print. The operator can specify 
detail in a report, then use the field names to 
indicate that the information from those fields is to 
be printed. The record detail can also contain 
previously defined answer variables and contstant 
text. 

If detail is not specified, the system creates the 
report without printing information from individual 
records . 

B A record group summary specifies text or extra 
spacing to be printed at the end of each group of 
records. You can use up to three group summaries in a 
report . 

IjI a report summary contains the text and instructions 
to be printed only at the end of the report. The 


Reports 11-1 


REPORT DESIGN WORKSHEET 


r 


'\ 


Report Preface 7'^^^^€^ ^_ :A^4(ifi%^ ^ ^;<i<^4g<it^g^a^^ 




^^^-■^^'^'*^^ '-'•^^T'-^^g:^^**^'^^ 


Page .Heading^^^ .^ ' ' ; ■; ■ ^ ^ ^^^ - „ , :„„'...■.; , „ , .:.: j-- ' ,, 1 , ^ \ .. ,'' ' 


Record Group Definition 1 ^ ^ ^^ aAJ^tI***^'^ (Field Name) 
Headings ' ; ^ . . _ ^^^.^^^ ^^-jr -^ ■'_■"'"'"'' ...^ ■ ; ; ' ' 


Tfo / HfUt^'-- ' ■• .- ' ^^a4^ 


Record Group Definition 2 \ ' ' ^ ■ ^^ .„ (Field Name) 

Headings _^ ; '■ ' ; ^ 


Record Group Definition 3 ;; ^^ ;; ..., , „„„...„ , „ „ „„. ^ .(Fi^ld'.Narne) 

Headings ' ''' ' . ^' '^ :; '- -, ■ ■ ■ ■ ■ 


Record Detail (what should print from each record) : ; , 


Record Group Summary 3 ' .^^ ^ ^ . ■ . ^^ (Field Name 


Record Group Summary 2' ' ■ " „ , ,.^ , !: ,„„ :„.l. ' (Field Name) 


Record Group Summary 1 ^ A^s^^xM^^td^tf 'i^' ^ (Field Name) 




R_e£ort^Summary 


<P(re^t,'<?^ o^^^^ :. Af- ^s^nHj^^^^-^ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 11-1 (Part 1 of 2), Sample Report With Report Parts Identified 
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This report is designed to give 

the reader 

an 

understanding of the 

D 

relationship of deparment, sex. 

and salary 

in 

two departments: 

Accounting and Administration. 

Managers' salaries are excluded. 


H EEO Report: Sex and 

Salary 


Accounting 




El 

Name 

Marilyn L. Velasco 
Carol A. Fisher 
Helen K. Morgan 
■Fw Roger T. Norton 
mm David Y. Clark 



Salary 

$16,783.00 
$20,387.00 
$22,839.00 
$18,378.00 




$22,918.00 


George J. Steiniger 



$20,298.00 


Walter M. Smith 



$24,893.00 


Maxwell A. Madison 



$25,298.00 

B 

Average Department Salary: 
Administration 

$21,474.25 



B 

Name 

Sue R. Burns 
Laverne W. Kelly 
Dorothy P. Boswell 
V<B Tracy S. Perry 
■" Nancy W. Tweeden 



Salary 

$10,500.00 
$11,892.00 
$12,827.00 
$11,456.00 




$14,284.00 


Brian K. Rogers 



$13,495.00 


Ralph R. Garcia 



$14,893.00 


Stanley P.. Lambert 



$18,394.00 

B 

Average Department Salary: 

$13,467.63 



O 

Overall Average Salary: $17,470.94 




Figure 11-1 (Part 2 of 2) . Sample Report With Report Parts Identified 
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report summary may contain an ending line or several 
pages of text. 


HOW TO COMPLETE THE REPORT DESIGN WORKSHEET 


BUILDING A REPORT 


Sorting the Records 


The Report Design Worksheet is used to organize the 
information necessary to create a report. A sample 
Report Design Worksheet is shown in Figure 11-1. Notice 
that it is divided into the same six parts as a report. 
You need to indicate which report parts and which group 
definition fields are to be used. 

When you fill out a Report Design Worksheet, you must use 
Sort Specifications. You can also use: 

• Record Selection Specifications to indicate what 
selection criteria to use 

• Math Instructions to indicate what math calculations 
to use 

In this chapter you'll learn how to design a report and 
how to fill out the Report Design Worksheet. There are 
sample Report Design Worksheets and shell documents shown 
with most of the examples in this chapter. 


The purpose of a report is to present information in a 
readable, useful format. A report does this by listing 
and grouping information. 

The easiest way to understand how a report works is to 
watch one being built. We'll create a report from the 
personnel file that contains information about the sex of 
employees and salaries. 


You already know that you can sort the records so that 
they print in a specific order. We'll start by listing 
all the records in the file in order, first by sex then by 
salary. Figure 11-2 shows the sorted list. 

Notice that the list could be divided in half, with 
females first then males. This list would be more 
readable if we identified each of the halves of the list. 
It would then be clearer that within the two halves of the 
list, the records are in order by salary. 
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Sue Burns 

F 

$10,500.00 

Administration 

Mavis Nelson 

F 

$10,987.00 

Personnel 

Tracy Perry 

F 

$11,456.00 

Administration 

Laverne Kelly 

F 

$11,892.00 

Administration 

Lisa Schultz 

F 

$12,384.00 

Planning 

Dorothy Boswell 

F 

$12,827.00 

Administration 

Karen Benson 

F 

$12,932.00 

Personnel 

Nancy Tweeden 

F 

$14,284.00 

Administration 

Marilyn Velasco 

F 

$16,783.00 

Accounting 

Lorna Boyle 

F 

$16,998.00 

Engineering 

Diane Preston 

F 

$18,909.00 

Engineering 

Theresa Black 

F 

$18,938.00 

Personnel 

Peggy Anderson 

F 

$20,283.00 

Personnel 

Gloria Young 

F 

$20,289.00 

Planning 

Cynthia Lee 

F 

$20,294.00 

Engineering 

Carol Fisher 

F 

$20,387.00 

Accounting 

Debbie Goodman 

F 

$22,098.00 

Marketing 

Helen Morgan 

F 

$22,839.00 

Accounting 

Jean Davidson 

F 

$23,890.00 

Engineering 

Trisha Park 

F 

$24,445.00 

Planning 

Lorna Chapman 

F 

$25,482.00 

Marketing 

Barbara White 

F 

$25,677.00 

Planning 

Cecelia Kahn 

F 

$25,849.00 

Marketing 

Rachel Forrest 

F 

$27,978.00 

Engineering 

Sherry Perkins 

F 

$29,082.00 

Marketing 

Thomas Jackson 

M 

$12,938.00 

Personnel 

James Ostrom 

M 

$13,283.00 

Planning 

Robert Lopez 

M 

$13,389.00 

Personnel 

Brian Rogers 

M 

$13,495.00 

Administration 

Ralph Garcia 

M 

$14,893.00 

Administration 

Simon Carrigan 

M 

$16,589.00 

Personnel 

Jeff Martin 

M 

$17,583.00 

Planning 

Roger Norton 

M 

$18,378.00 

Accounting 

Stanley Lambert 

M 

$18,394.00 

Administration 

Simon Swanson 

M 

$18,890.00 

Engineering 

Frank Wilson 

M 

$20,283.00 

Planning 

George Steiniger 

M 

$20,298.00 

Accounting 

David Clark 

M 

$22,918.00 

Accounting 

Walter Smith 

M 

$24,893.00 

Accounting 

Maxwell Madison 

M 

$25,298.00 

Accounting 

Walter Smith 

M 

$25,829.00 

Personnel 

Gerald Ostrom 

M 

$25,998.00 

Marketing 

Jack White 

M 

$27,892.00 

Marketing 

Michael Acker 

M 

$27,898.00 

Engineering 

Roger Knight 

M 

$28,382.00 

Marketing 

Victor Fisher 

M 

$31,839.00 

Marketing 

Richard Bradley 

M 

$32,893.00 

Planning 

Allen Hunt 

M 

$32,938.00 

Engineering 


Figure 11-2. Records Sorted by Sex and Salary 
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Using a Record Group Definition and a Group Summary 

A record group definition in a report allows us to divide 
the sorted list into meaningful parts by defining a group 
of records. A group is a set of records that all have the 
same value in a specified field. In our example, the 
specified field is Sex. 

Once a group is defined, we can add a group heading to be 
printed before each group and a record group summary be 
printed after each group. In Figure 11-3, we have added a 
( 1 ) group heading and ( 2 ) a record group summary. 

How A Record Group Definition Can Be Used 

A record group definition has several functions: 

• It defines a group. 

• It can contain a group heading to be printed at the 
beginning of every group. 

• It can contain math calculations. 

• It must be used if a group summary is used. 

A record group definition's primary function is to define 
a group. For each record group definition, up to the 
limit of three per report, you must specify a field. By 
definition, the value in the record group definition 
field must be the same for every record in a group. 
(Remember, a group is composed of the records that have 
the same value in the record group definition field.) 

If you want to define a record group definition, fill in 
the name of the defining field in the blank following 
"Record Group Definition l" on the Report Design 
Worksheet . 

A group heading can contain text, variable names, and 
math calculations. The text and variable information are 
printed at the beginning of every group to provide 
headings for the groups of information. 

If you want the information in the field used to define 
the group to print, the field name can be included as a 
variable in the record detail. However, since the 
information is the same for every record in the group 
(that's how the group is defined), you may prefer to have 
that information print only once for each group. To avoid 
printing this value with every record in a group, you can 
use the field name as a variable in the group heading. 
The value in this field is then printed only once at the 
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beginning of the group. In our example, the group 
definition field is Sex, so the values F and M were each 
only printed once. 

If you are using a running total that is to be calculated 
based on the information in a group, use a math 
instruction to make your answer variable for the running 
total equal to zero. The math calculations, of course, 
are not printed. See Figure 8-3 in Chapter 8 for an 
example of a math calculation used in a record group 
definition. 

All text and variables to be printed as the group heading 
and math calculations, such as setting the answer 
variable for a running total equal to zero, should be 
written following "Group Heading" for Record Group 
Definition 1 on the Report Design Worksheet. You can save 
space by using the Ref . No. from the Math Instructions 
Worksheet to indicate where the math calculations will be 
typed, rather than writing in the complete calculation. 


How Record Group Summaries Can Be Used 


A record group summary can contain text, extra spacing, 
variables names such as a field name or an answer 
variable, and math calculations. A record group summary 
can also contain a page end code to force each group of 
records to print on a separate page. In Figure 11-3 the 
record group summary contains a carrier return, a line of 
asterisks, and another carrier return. 

If you are calculating a running total for a group, you 
can print the total for the group in the summary by using 
the answer variable in the record group summary. 
(Remember, through, that the actual math calculation is 
done in the record group definition.) 

A record group summary can contain math calculations. In 
addition to the math instructions that you are already 
familiar with, you can also use summary math 
instructions. These instructions are explained in the 
following section. 

Note: You must use a record group definition in order to 
have a group summary. The system cannot put information 
at the end of a group if the group hasn't been defined. 


Summary Math Instructions 


Summary math instructions allow you to automatically do 
some of the most common math calculations for groups of 
records . Within a record group summary or a report 
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" I 

Katae 



Sal£ 

iry 
500. 

00 



Sue R. B 

urns 

$10 


Mavis Y. 

Nelson 

$10 

987. 

00 



Tracy S. 

Perry 

$11 

456. 

00 



Laverne 

W. Kelly 

$11 

892. 

00 



Lisa G. 

Schultz 

$12 

384. 

00 



Dorothy 

P. Boswell 

$12 

827. 

00 



Karen J. 

Benson 

$12 

932. 

00 



Nancy W. 

Tweeder 

$14 

284. 

00 



Marilyn 

L. Velasco 

$16 

783. 

00 



Lorna A. 

Boyle 

$16 

998. 

00 



Diane K. 

Preston 

$18 

909. 

00 



Theresa 

H. Black 

$18 

938. 

00 



Peggy L. 

Anderson 

$20 

283. 

00 



Gloria F 

. Young 

$20 

289. 

00 



Cynthia 

R. Lee 

$20 

294. 

00 



Carol A. 

Fisher 

$20 

387. 

00 



Debbie S 

. Goodman 

$22 

098. 

00 



Helen K. 

Morgan 

$22 

839. 

00 



Jean T. 

Davidson 

$23 

890. 

00 



Trisha J 

. Park 

$24 

445. 

00 



Lorna J. 

Chapman 

$25 

482. 

00 



Barbara 

N. White 

$25 

677. 

00 



Cecelia 

B. Kahn 

$25 

849. 

00 



Rachel L 

. Forrest 

$27 

978. 

00 



Sherry J 

. Perkins 

$29 

082. 

00 


' ***A>V>VA»V*i%**>^A<*Jk)f<****A**5V)?;**)5.**A*t*****A***'A*^ 

<***V!;S'*I 

M 

Name 


Salt 

938. 

00 


Thomas U 

. Jackson 

$12 


James R. 

Ostrom 

$13 

283. 

00 



Robert ^ 

. Lopez 

$13 

389. 

00 



Brian K. 

Rogers 

$13 

495. 

00 



Ralph R. 

Garcia 

$14 

893. 

00 



Simon E. 

Carrigan 

$16 

5fi9. 

00 



Jeff D. 

Martin 

$i7 

58J. 

00 



Roger T. 

Norton 

$18 

378. 

00 



Stanley 

R. Lambert 

$18 

394. 

00 



Simon E. 

Swanson 

$18 

890. 

00 



Frank P. 

Wilson 

$20 

283. 

00 



George J 

. Steiniger 

$20 

298. 

00 



David Y. 

Clark 

$22 

918. 

00 



Walter > 

. Smith 

$24 

893. 

00 



Maxwell 

A. Madison 

$25 

298. 

00 



Walter A 

. Smith 

$25 

829. 

00 



Gerald S 

. Ostrom 

$25 

998. 

00 



Jack E. 

White 

$27 

892. 

00 



Michael 

F. Acker 

$27 

898. 

00 



Roger H. 

Knight 

$28 

382. 

00 



Victor F 

. Fisher 

$31 

839. 

00 



Richard 

J. Bradley 

$32 

893. 

00 



Allen K. 

Hunt 

$32 

938. 

00 


:****sVs 

<***A!S,-*;*!i^5lt«;5^-3fe***5S;;«:******A5VAA) 

f**ft*A*A****s%*A*«r**'*'*j^A5!c*^***t*A>V>'r 

{*>'<** AsV 








Figure 11-3 (Part 1 of 2). Report With A Group Heading and A Group Summary 
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REPORT DESIGN WORKSHEET 


Report Preface 




Page Heading 



Record Group Definition 1 ^.e^^ 
Headings V :^.^^ V" 

(Field Name) 

7<7^fc/»vA- 

j^^r^J^sfc-*-*^ 

-— -— ^ 

Record Group Definition 2 
Headings 

(Field Name) 



Record Group Definition 3 
Headings 

(Field Name) 



Record Detail (what should print 

from each record) 

-V^ ?AMt >7^t*M^-i^ ^f- mT-'tii'XA^ T^O'yrue.^f' V- ■^a£,>^i^ -¥" 

w 


Record Group Summary 3 

(Field Name 



Record Group Summary 2 

(Field Name) 



Record 'Group Summary 1 ^^.4>iiC 

(Field Name) 

Hr ^ ¥r ^ -je ^ # 4(- ^ 

^^.^^^^^>^ 

(f<;;<!U-^i,<e.4, „x^^i5^--t,-#«- ) 

Report -Summary 





You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 

Figure 11-3 (Part 2 of 2). Report With A Group Heading and A Group Summary 


Reports 11-9 


summary, a summary math instruction can be used to 
calculate: 

the total of the values in a math field 

the highest value found in a math field 

the lowest value found in a math field 

the average of the values in a math field 

the number of records within a group or within the 
report 

Since calculating these values requires several math 
instructions, it can be easier to use summary math 
instructions. For example, calculating the average of a 
group of records would normally require three math 
calculations to: 

• count the number of records 

• add the values in the fields 

• divide the total of the values by the number of 
records 

Only one summary math instruction is required, however, 
to calculate the average of a group of records. 


Each summary math instruction contains a variable name 
for answer, a field name, and type of calculation. 
(Remember that summary math can only be used with values 
in a field . ) The answer to a summary math calculation is 
stored in an answer variable. The answer variable can be 
printed as variable information, and it can be used as a 
number in a math calculation. Figure 11-4 shows the same 
report as Figure 11-3 but, instead of a row of asterisks, 
the record group summary contains a summary math 
instruction to average the Salary field for each group. 

A summary math instruction uses the values from all the 
selected records in a group (if placed in a record group 
summary) or in the report (if placed in the report 
summary). You can use both summary math instructions (for 
calculations involving values in a field) and math 
instructions in the same group summary or report summary. 
You can use up to 20 variable names for answers in a 
report. 

All text and variables to be printed in the record group 
summary, and math calculations to be done in the record 
group summary should be written after "Record Group 
Summary l" on the Report Design Worksheet. You can save 
space by using the Ref . No. from the Math Instructions 
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Worksheet to indicate where the math instructions will be 
typed, rather than writing in the complete calculation. 



SUMMARY 

MATH INSTRUCTIONS 

REF. 
NO.* 

VARIABLE NAME 
FOR ANSWER''"'- 

OPERATION-"-""'"- 

FIELD TO BE COMPUTED'""'-' 

SMI 

<t/iAeut^>2-' 

CiA^^AjX^Sf''^-- 

Sk£iA^^t^ 

SM2 

(f 


(T 

SMS 




SM4 




SMS 




SM6 




SM7 





■"""Operations are Count, Average, Total, High, Low 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

5^ 

^OW TO high)/ high to LOW 

FIELD TO BE SORTED SECOND 


LOW TO high / high TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / high TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / high TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


Figure 11-4 (Part 1 of 3). Report With a Summary Math Instruction in the Record 

Group Summary 


Reports 
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F 


Name 

Salar;)!;^ 

Sue R. Burns 

$10,500.00 

Mavis Y. Nelson 

$10,987.00 

Tracy S. Perry 

$11,456.00 

Laverne W. Kelly 

$11,892.00 

Lisa G. Schultz 

$12,384.00 

Dorothy P. Boswell 

$12,827.00 

Karen J. Benson 

$12,932.00 

Nancy W. Tweeder 

$14,284.00 

Marilyn L. Velasco 

$16,783.00 

Lorna A. Boyle 

$16,998.00 

Diane K. Preston 

$18,909.00 

Theresa H. Black 

$18,938.00 

Peggy L. Anderson 

$20,283.00 

Gloria F. Young 

$20,289.00 

Cynthia R. Lee 

$20,294.00 

Carol A. Fisher 

$20,387.00 

Debbie S. Goodman 

$22,098.00 

Helen K. Morgan 

$22,839.00 

Jean T. Davidson 

$23,890.00 

Trisha J. Park 

$24,445.00 

Lorna J. Chapman 

$25,482.00 

Barbara N. White 

$25,677.00 

Cecelia B. Kahn 

$25,849.00 

Rachel L. Forrest 

$27,978.00 

Sherry J . Perkins 

$29,082.00 

Average Salary: $19,099,32 


M 

Name 

Salary 

Thomas W. Jackson 

$12,938.00 

James R. Ostrom 

$13,283.00 

Robert M. Lopez 

$13,389.00 

Brian K. Rogers 

$13,495.00 

Ralph R. Garcia 

$14,893.00 

Simon F. Carrigan 

$16,589.00 

Jeff D. Martin 

$17,583.00 

Roger T. Norton 

$18,378.00 

Stanley R. Lambert 

$18,394.00 

Simon E. Swanson 

$18,890.00 

Frank P. Wilson 

$20,283.00 

George J. Steiniger 

$20,298.00 

David Y. Clark 

$22,918.00 

Walter M. Smith 

$24,893.00 

Maxwell A. Madison 

$25,298.00 

Walter A. Smith 

$25,829.00 

Gerald S, Ostrom 

$25,998.00 

Jack E. White 

$27,892.00 

Michael F. Acker 

$27,898.00 

Roger H. Knight 

$28,382.00 

Victor P. Fisher 

$31,839.00 

Richard J. Bradley 

$32,893.00 

Allen K. Hunt 

$32,938.00 

Average Salary: $21,964.83 



Figure 11-4 (Part 2 of 3) . Report With a Summary Math Instruction in the Record 

Group Summary 
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REPORT DESIGN WORKSHEET 


Report Preface^ 


Page Heading 


Record Group Definition 1 %^s>^„ 
Headings -^ ^e^-^ 


(Field Name) 


r?<3-»rce-' 




Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


V^^^;]<^a/">^^:tr*t^V V-MXV^ V- odu*^;^ V'5k>^a^-{^ 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


RaawwLsGroup Summary 1 ^^e<*^ 


(Field Name) 


43>t^e<t>tf^ ■:?^g^^^ -Y^ aAJf-e/tJ0L<a^'V^ 


Report Summary__ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 

Figure 11-4 (Part 3 of 3). Report With a Summary Math Instruction in the Record 

Group Summary 
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Using Page Headings and Report Summaries 


Figure 11-5 shows the report from Figure 11-4 with two 
additional report parts. Page headings ( 1 ) and a report 
summary ( 2 ) have been added to make the report even more 
readable. 


How A Page Heading Is Used 


A page heading contains text that is printed following 
the report preface and at the top of every page, up to the 
report summary. It can be a report title or column 
headings, and it can print on more that one line. A page 
heading can not, however, contain variable information or 
math calculations. 

Write in the information that you want in the page heading 
on the lines following "Page Heading" on the Report 
Design Worksheet. 


How A Report Summary Is Used 


A report summary prints at the end of a report . It can 
contain text, variable information, and math 
calculations. If a summary math instruction is used in 
the report summary, it uses values from every record in 
the report. A report summary can be several pages in 
length. 

Write in the information to be used in the report summary 
on the lines following "Report Summary" on the Report 
Design Worksheet. 
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EEO Report: Salttry and Sex ' 





Name 

Salary 





Sue R. Burns 

$10,500.00 





Mavis Y. Nelson 

$10,987.00 





Tracy S. Perry 

$11,456.00 





Laverne W. Kelly 

$11,892.00 





Lisa C. Schultz 

$12,384.00 





Dorothy P. Boswell 

$12,827.00 





Karen J. Benson 

$12,932.00 





Nancy W. Tweeden 

$14,284.00 





Marilyn L. Velasco 

$16,783.00 





Lorna A. Boyle 

$16,998.00 





Diane K. Preston 

$18,909.00 





Theresa H. Black 

$18,938.00 





Peggy L. Anderson 

$20,283.00 





Gloria F. Young 

$20,289.00 





Cynthia R. Lee 

$20,294.00 





Carol A. Fisher 

$20,387.00 





Debbie S. Goodman 

$22,098.00 





Helen K. Morgan 

$22,839.00 





Jean T. Davidson 

$23,890.00 





Trisha J. Park 

$24,445.00 





Lorna J. Chapman 

$25,482.00 





Barbara N, White 

$25,677.00 





Cecelia B. Kahn 

$25,849.00 





Rachel L. Forrest 

$27,978.00 





Sherry J. Perkins 

$29,082.00 





Average Salary: 

$19,099.32 





Name 

Salary 





Thomas W. Jackson 

$12,938.00 





J amies R. Ostrom 

$13,283.00 





Robert M. Lopez 

$13,389,00 





Brian K. Rogers 

$13,495.00 





Ralph R. Garcia 

$14,893.00 





Simon F. Carrigan 

$16,589.00 





Jeff D. 






Roger T, 


, ._,,„„ .,„...,„ , .,,,. „., „. .„.„ 




Stanley 


:: EEO Report: Salary and 

Sex . 



Simon E. 






Frank P. 






George . 


Roger H. Knight 

$28 

382 

00 

David Y 


Victor P. Fisher 

$31 

839 

00 

Walter I 


Richard J. Bradley 

$32 

893 

00 

Maxwell 


Allen K. Hunt 

$32 

938 

00 

Walter i 






Gerald ! 


Average Salary: $21,964.83 




Jack E. 






Michael 


Summary ^ 

Average Company Salary: $20,472.38 j 






^-^^^ 

^ ^__^^ ^_^ 

, . 





Figure 11-5 (Part 1 of 3). Report With A Page Heading And A Report Summary 


Reports 
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REPORT DESIGN WORKSHEET 


Report ■. Preface^ 


Page . Headin g- '■ •^"'„ - '' '^r;- ■ " ' ' ' ■'■ ■'■'"''", - ■■■■^'^' "' ■ ' . , 


Record' Group; Definition^;! . ^^^ ; ^ ,.S^^„- 
Headings 


(Field Name): 


" ^ftr ^^ 


Record : Group Def init ion 2 
He adings '"■" ■ ■ — ■ 


(Field Name) 


Record Group Definition 3 

Headings ..;. /':.■:■;;,;' :-.":-:' : .- ' ■ 


(Field Name) 


Record Detail (what^ should print from each record) ;: 


Record: Group :Summary; 3 


(Field Name; 


Record Group Summary 2 


(Field Name) 


Rejiac^^oup:: Summary ' ''■•':S-Jt^:[ ''■'■■'■ ■ \ _ (Fie id -Name);' 


Kesjix^br 


"I^^^^^^^IM^^^^MII^E^^^^^^^^L 


Su mmary 


''Oi^^tA^. 




You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 11-5 (Part 2 of 3). Report With A Page Heading And A Report Summary 
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SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

_5^ 

(L0\^ TO HIGH)/ HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 



SUMMARY 

MATH INSTRUCTIONS 


REF. 
NO.* 

VARIABLE NAME 
FOR "ANSWER''""' 

OPERATION-'"'-*'^ 

FIELD TO, BE 

COMPUTED''"'' 

SMI 

^kf€tzi^jz^ 

(X^Atn^a-^^^a^ 

£^^^£x4^ 

SM2 ' 

</ 


SaJca-'*'''^^ 

SH3 


ir"\ 

,';';■■ J^ 

SM4 




SMS 




SM6 




SM7 





•Operations are Count, Average, Total, High, Low 


Figure 11-5 (Part 3 of 3). Report With A Page Heading And A Report Summary 


Reports 
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Using A Report Preface 


Figure 11-6 shows the same report as Figure 11-5, but a 
report preface has been added. A report preface can 
contain text, variable information, and math 
calculations. It is printed only once, at the beginning 
of the report, and can be several pages long. 

If you want to use a running total that includes values 
from the entire report, use a math calculation in the 
report preface that makes your answer variable for the 
running total equal to zero. 

Note: Anything typed in the shell document before a 
report instruction appears on the display, but is not 
printed. If you have any information that you want 
printed at beginning of a report, it must be included in 
the report preface. 

In Figure 11-6, we used the report preface to provide the 
reader with some additional information about the report. 
If you want to use a report preface, write it on the lines 
following "Report Preface" on the Report Design 
Worksheet. 
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[ This report is designed to give the reader an understanding of the 

[ relationship of department, sex, and salary 

in two 

departments: 

■Accounting and Administration. Managers' salaries 

are not included. 

EEO Report: Sex and 

Salary 


Accounting 



Name 


Salary 

Marilyn L. Velasco 


$16,783.00 

Carol A. Fisher 


$20,387.00 

Helen K. Morgan 


$22,839.00 

Average Department Salary: $20,003.00 



Accounting 



Name 


Salary 

Roger T. Norton 


$18,378.00 

George J. Steiniger 


$20,298.00 

David Y. Clark 


$22,918.00 

Walter M. Smith 


$24,893.00 

Maxwell A. Madison 


$25,298.00 

Average Department Salary: $22,357.00 



Administration 



Name 


Salary 

Sue R. Burns 


$10,500.00 

Tracy S. Perry 


$11,456.00 

Laverne W. Kelly 


$11,892.00 

Dorothy P. Boswell 


$12,827.00 

Nancy W. Tweeden 


$14,284.00 

Average Department Salary: $12,191.80 



Administration 



Name 


Salary 

Brian K. Rogers 


$13,495.00 

Ralph R. Garcia 


$14,893.00 

Stanley R. Lambert 


$18,394.00 

Average Department Salary: $15,594.00 



Overall Average Salary: $17,470.94 




Figure 11-6 (Part 1 of 3) . Report With Report Preface 


Reports 
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REPORT DESIGN WORKSHEET 


Report '^x^teiC ^'y'if^^ ,,/pz,j(i^^ yijetA.4e£€/L^ 



.Zt,^ ^*^ <y^g;^<feg^Z»WR)Ni^/ ^2Cd:^fii^s-*'t-'Z^^ av^^"^ 


, 7^/t^ai^:jS't4^^,^y^i,0sLiz,<j^^ if&'ze g:^6<97f,<!>i»<<s^^<g^!faa<^ 


Page Heading ^ ^^^ j ^ -^-f 


Record Grou|> Definitional Xja»44'tfc'Vt»v>!^ (Field Name) 
Headings ^ iM^jfoAjti'^t^*^-^'^ ~ 


Record Group Definition 2 ^ie^ (Field Name) 
Headings^ 


."T ^a^fff ^ 


-^^ 


Record Group Definition 3 _.________„ (Field Name) 

Headings ^^ 


Record Detail (what should print from each record) 


Record Group Summary 3 (Field Name 


Re£yird___Group Summary 2 ^^ jgu»>^... (Field Name) 


a.,.^ ^ ^^^w;;-^ , ^^^ , ^....^g: 


^JpA^i^md'^ 


Record Group Summary 1 M^p»^M'<>*t^i*-*^ (Field Name) 


-"' — '^ 


^/u€juiM ^^W<y Sa/a^^^ / -¥- ^tt0ta£/ i^ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 11-6 (Part 2 of 3). Report With Report Preface 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA' 

/ 

qu£^ 

^ Tl^a^Opp^e/L- 


r 





















SORT SPECIFICATIONS 



FIELD NAME " 

■ / KIND OF. SORT. 

FIEI.D TO BE SORTED FIRST 

i/£pM(m£'iA^ 

CLoirrojii^/ high to low 

FIELD TO BE SORTED SECOND 


(low to, high)/ high to, low 

FIELD TO BE SORTED THIRD; 

Sa£atA^ 

:<|0W T0lilp>/ HIGH TO LOW 

FIELD TO BE SORTED FOURTH 

./^, ;.:::.,;;-, v.; 

; low-to HIGH / .HIGH TO LOW' ^ 

FIELD TO BE SORTED FIFTH 

:■'/■•'■ V ■■= ■■■■::r-^^-- ■,:/-^ 

: -ioW; T0;^H1GH / : HIGH ; TO - LOW - ■ 


SUMMARY MATH INSTRUCTIONS 


REF, 
NO.'^ 


VARIABLE NAME 
FOR ANSWER'"-"-' 


OPERATION*--'"' 


FIELD TO BE COMPUTED''- 


SMI 


^;;;iAM^a^ceL. 


gju-€n.Ou , ^ML^ ^^^^^^^ 


Sdi/a^ 


SM2 


df^f^miJ^ 


OAfOl 


£^^ 


4m^4& 




SM3 


SM4 


SH5 


Figure 11-6 (Part 3 of 3) . Report With Report Preface 


Reports 
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Using Record Detail 


So far, we've been printing record detail, the 
information from every record in each group. However, at 
times, you may want only summary information about a 
group and not the record detail. Reports, such as the one 
in Figure 11-7, can be printed with headings and 
summaries without any record detail. 
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To answer the nany questions we've received, we've prepared the 
following report which gives a summary of salaries. This list is 
divided by sex. 

Managers' salaries are not included. 


EEO Report; Salary and Sex 


Average Salary; 
Highest Salary: 
Lowest Salary: 

M 

Average Salary; 
Highest Salary: 
Lowest Salary: 


$19,099.32 
$29,082.00 
$10,500,00 


$21,964.83 
$32,938.00 
$12,938.00 


Average Company Salary: $20,472.38 
Highest Company Salary: $32,938.00 
Lowest Company Salary: $10,500.00 


Figure 11-7 (Part 1 of 3) . Report Printed Without Detail 


Reports 
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REPORT DESIGN WORKSHEET 


Report Preface^^^^^ga^^^t^^g^ t^^ Tn^t^n^. ,,^i^^'e^i:?^^€rf^^..^ 


/^Lu^Ptt^^^A^ & ^ ,.cLA^,»^t^cX^ . -JJU^ K^i^^^^ aCc/»^l(>U^»^ ^ AL^."^ 


/^''?^g^ ,.a p g!'25tftrr.„,,<^^ If'^i*^'''^''-**'^^ 


Page Heading^^^^ ^^^^ ^^^^ ,, 

'g'^^ /^^,gt.»t^/ ^:c^^^ ^".X^ 


Record Group Definition 1 ,S<a:^ (Field 
Headings ^ ^ ^V- j£]<?y:: ^^ -V^^ 


Record Group Definition 2 ______________ (Field Name) 

Headings 


Record Group Definition 3 (Field Name) 

Headings . ^ . ^ 


Record Detail (what should print from each record) 


Record Group Summary 3 (Field Name 


Record Group Summary 2 (Field Name) 


I Hlffl>»| >M ■^lUNltliCTlllM^I'HM 


Record Group Sumtnary 1 ^le^ (Field Name)^S^Z-) (j^^ ^fll^ 

^ ^hf^4^c^^c^ <'a.,^y ^ .. , . , ., ..., 


^0.t.j.je>tjf J^cJ^OA^ .' '^,J^i»<.^-V^ 


Report Summary ■ Q^^ ^^^^^^S^ ^^^^^'" 




p^tur-e ^ ^%^^&^>*^ XlSiA ^ t -K affl^^»-^--''-t^ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 11-7 (Part 2 of 3). Report Printed Without Detail 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 

: LINE 

"...FIELD , 

SELECTION CRITERIA 

/ 

'-^:6^ 

4^ ?^ay9ta.pe^ 


^ 















SORT SPECIFICATIONS 


'. , " ' ' ' ' 

FIELD NAME 

Kim OF SORT 

FIELD TO, BE: SORTED FIRST 

S£^ 

(]loW TO~ilGHp/ HIGH TO' LOW ■: 

FIELD ■TO BE ' SORTED SECOND 


LOW TO HIGH- / HIGH- TO LOW ■ },■: ' 

FIELD TO, BE SORTED THIRD 

.. ' 

LOW TO HIGH 7 HIGH TO LOW. .; 

FIELD TO, BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE^ SORTED FIFTH ■ 


LOW. TO HIGH 7 HIGH , TO LOW ' ;■ 


SUMMARY MATH INSTRUCTIONS 


REF. 
NO.* 


VARIABLE NAME 
FOR ANSWER*'** 


OPERATION*-'"'*- 


FIELD TO BE COMPUTED** 


SHI 


^lAf-^n^ce 


Sit^A.^^ 


'&^ 


'^^^i£aAi^ 


SM2 


yu^ 


jS< 




SM3 


^£*^£^ 


Ji»<nr^ 


^a£n^^ 


SH4 


C^'tM^-en.A^^e^ 


<;3^<HSt.<w;fZ^ 


^ 




SMS 


Ce^^t^^ 


/^^ 


S^ 


4tc.<fitjt-<gt^ 


SH6 


^.,£a«j- 


J&H^y^ 


5^ 


SM7 


****Ope rat ions are Count, Average, Total, High, Low 

Figure 11-7 (Part 3 of 3) . Report Printed Without Detail 


Reports With More Than One Group Definition 


So far, you've learned how to use report instructions to 
make a report more readable. However, a report should 
also make the file information more usable. You may need 
to create a report that divides the file information into 
smaller, more defined groups. You can do this by using up 
to three group definitions. 

Using multiple record group definitions is similar to 
sorting the file on more than one field; 

1. The records are divided into groups according to the 
first group definition (Record Group Definition 1) . 

2. Then the records within each group are divided into 
subgroups according to the second record group 
definition (Record Group Definition 2). 

3. Finally, each subgroup is divided according to the 
third record group definition (Record Group 
Definition 3) . 

Figure 11-8 shows the records in a report format with 
Department as the first record group definition field and 
Sex as the second record group definition field. 
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EEC Report: Sala 

ry and Sex 

Accounting 




F Name 



Salary 

Marilyn L. Velasco 
Carol A. Fisher 
Helen K. Morgan 



$16,783.00 
$20,387.00 
$22,839.00 

Average Salary: $20 

003 

00 


M Name 



Salary 

Roger T. Norton 
George J. Steiniger 
David Y. Clark 
Walter M. Smith 
Maxwell A. Madison 



$18,378.00 
$20,298.00 
$22,918.00 
$24,893.00 
$25,298.00 

Average Salary: $22 

357 

00 


Average Department Salary: 

$21 

474.25 


Administration 




F Name 



Salary 

Sue R. Burns 
Tracy S. Perry 
Laverne W. Kelly 
Dorothy P. Boswell 
Nancy W. Tweeden 



$10,500.00 
$11,456.00 
$11,892.00 
$12,827.00 
$14,284.00 

Average Salary: $12 

191 

80 


M Name 



Salary 

Brian K. Rogers 
Ralph R. Garcia 
Stanley R. Lambert 



$13,495.00 
$14,893.00 
$^8,394.00 

Average Salary: $15 

594 

00 


Average Department Salary: 

$13 

467.63 



Figure 11-8 (Part 1 of 3) 


Report With Two Group Definition Fields --Department 
and Sex 


Reports 
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REPORT DESIGN WORKSHEET 


Report Preface 


Page Heading^ 


<!ggff] V ^<a a a^^ Sa ^fi^^ rrU ..JifeT 


Record Group Definition 1 >(^^<at»^^^4g**f (Field Name) 
Headings ■^J)je!^au'^l^f>-it^-»f^ 


Record Group Definition 2 S^t£-... 


ings .y ^J&iC-¥^ yif/!U'*%js^ 


(Field Name) 

.■ ^g^^g^-^^M -^ac 


Record Group Definition 3 

Headings., 


(Field Hame) 


Record Detail (what should print fmm each record) 


Record Group Summary 3 


(Field Name 


Re cord Group Summary 2 : $S5^ (Field Name) 


(Field Name) 


Record Group Summary 1 ^Jp C ^^j/yt-i^^ 


Report Summary 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 11-8 (Part 2 of 3). Report With Two Group Definition Fields --Department 

and Sex 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

/ 

4!?/ w&^ 

^ ?^4^a^^eyu 

/ 

ihpM^^WJt^ 

^ , f ; 


7 

■ f ■ ■ 






^ 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT , ' - 

FIELD TO BE SORTED FIRST 

flmM/lnt&tO^ 

(<0W"t0 HIGH^/ HIGH TO LOW • 

FIELD TO BE SORTED SECOND 

:^i^ ^ 

Clow TolnGgpz-HiGH to low' 

FIELD TO BE SORTED THIRD 

^a/^u^ 

(Tow tohigh>/ high to low 

FIELD TO BE SORTED FOURTH 

■"' a^ 

low to high / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 



SUMMARY 

MATH INSTRUCTIONS 

REF. 

VARIABLE' NAME ' 
FOR ANSWER-'"'' ' 

OPERATION-''-'"'^-''' 

FIELD TO BE COMPUTED'^'- 

SMI 

i^A^^^-^Hf^ 

U4f^^^.^ 

SaMiy*-H^ 

SM2 

. <3 

Sm-€Ajs^CJ2^ 

^ 

SM3 

t cr 

a 

^ 

SM4 




SMS 




SM6 




SH7 





■f ""Operations are Count, Average, Total, High, Low 


Figure 11-8 (Part 3 of 3) . Report With Two Group Definition Fields --Department 

and Sex 


Reports 11-29 


Figure 11-9 shows the same information as Figure 11-8, 
but the group definition fields have been reversed so 
that Sex is the first record group definition field and 
Department is the second record group definition field. 

Notice that the information in the record group summaries 
becomes more usable as you use more record group 
definition fields, because each record group summary 
describes a smaller, more specific group of records. 
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EEO Report: Salary by Sex and Department 


Admin i K t r a 1 3 o n 

Name 

Brian K. Rogers 
Ralph R. Garcia 
Stanley R. Lambert 

Average Department Salary (M) : $15,594.00 


Average Salary: $19,820. 


Salary 

$13,495.00 
$14,893.00 
$18,394.00 


EEO Report: Salary by Sex and Department 


Accounting 

Name 

Marilyn L. Velasco 
Carol A. Fisher 
Helen K. Morgan 

Average Department Salary (F) : $20,003.00 

Administrati on 

Name 

Sue R. Burns 
Tracy S. Perry 
Laverne W. Kelly 
Dorothy P. Boswell 
Nancy W. Tweeden 

Average Department Salary (F) : $12,191.80 


Average Salary: $15,121.00 


Accounting 

Name 

Roger T. Norton 
George J. Steiniger 
David Y. Clark 
Walter M. Smith 
Maxwell A. Madison 

Average Department Salary (M) : $22,357.00 


Salary 

$16,783.00 
$20,387.00 
$22,839.00 


Salary 

$10,500.00 
$11,456.00 
$11,892.00 
$12,827.00 
$14,284.00 


Salary 

$18,378.00 
$20,298.00 
$22,918.00 
$24,893.00 
$25,298.00 


Figure 11-9 (Part 1 of 3). Report With Two Group Definition Fields--Sex and 

Department 


Reports 
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REPORT DESIGN WORKSHEET 


Report Preface^ 


Page- Heading £^£<> ___ f^&iUi^2 ^^!tJkl^ '^..„=ij^....<^ , f^ •^^. ' f'^^i^**^^'^ ^ 


Record Group Definition. 1 ^^ l^^fi-^ (Field Name) 

Headings -jr-.S^ ^ 


Record Group. Definition 
Head ings H;^ ^jgAa^t/jtiinJt^ff'j^ 


(Field Name) 


^w.y:s-» " ^ 


^^^^^^^^ ^ 


Record Group Definition 3 

Head ings " 1 


(Field Name) 


Record Detail (what should print from each record)- ,, 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


Si^^ti^^l^ 


(Field Name) 


(U^/lOfC. i^j^aud^^Zt^ Sa&^ 6i^S^V) : -^.gtt^^-*^'^^-^ 


Reco.. =.o„p'su..a„ 1 ^- (Field Na„., (^g) 




-if- 


Report Summary 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 11-9 (Part 2 of 3) . Report With Two Group Definition Fields--Sex and 

Department 


11-32 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

/ 

fyxjaamrUMA 

■=^ (ie^C4>CL.fpti^ / := (^2a4^*«.»*«kM<2^^<wa. 

/ 

4j-dd4rel 

7^ yrf^i^Af-au 


^r 

u ■■ ' ' ■ ■ "■■■■ 








SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

' 

Se^ 

(Iow'tO "hiSI>/ HIGH TO LOW 

FIELD TO BE. SORTED SECOND 

^h^OAZt^uiyr^ 

(JOW TO HIGH)/ HIGH TO LOW 

FIELD TO BE SORTED THIRD 


(fow TO HI^/ HIGH TO LOW 

FIELD TO BE SORTED FOURTH 

d 

LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED. FIFTH 


LOW TO HIGH / HIGH TO LOW 



SUMMARY 

MATH INSTRUCTIONS 

REF. 
NO.* 

,VARIABLE NAME ■■ ., 
FOR ANSWER-'W' ^ 

OPERATION-'^v.'.-.v 

FIELD TO BE COMPUTED** : 

SMI 

iiM€^^^JL~ 

Cli}-OiA<^ 

Siil££</i<j. 

SM2 



^fijin^. Aif-^'ut-i;''^ 

^l/V<A.fi^C^eL~ 

S'!z£^^^*''C^ 

SM3 



^ 

SM4 




SH5 




SM6 




SM7 





'Operations are Count, Average, Total, High, Low 


Figure 11-9 (Part 3 of 3). Report With Two Group Definition Fields--Sex and 

Department 
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ADDITIONAL FUNCTIONS YOU CAN USE WITH REPORTS 


You can use some of the functions already discussed with 
reports . Remember that you must sort the records in order 
to do a report. The first sort fields should be the same 
as the record group definition fields. 

You can also use: 

• select records for merging 

• conditional text instructions 

• math instructions 
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This page intentionally left blank. 


Reports 11-35 


REVIEW QUESTIONS 


On the following page are sample reports. Using the 
information from the File Design Worksheet shown below, 
fill in Report Design Worksheets to produce the sample 
reports . 


FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE-'' 


NUMBER OF 
CHARACTERS- 


COMMENTS 


C/lA^'ia?^UJi,y^a>rnL> 


d/a/u 


as^ 


A^^ 


LQCL. 


0,6 


CampAnc f 


/VLO/rrULJ 



/s 


>o;At:/ly - M^oji^ oA/^^jut^i^cCiiltn^ 


:^z^ 


A 


/iJti^ (fY Ciryt:6ic/ y:iJt/L<ycyt^ 


floud yiO/mxj 


/O 


>n^ 


.z/yuiJua6u> ja4AyrUi7te.ocOA:/ryt^ 


c^OAl/' ^^O/TttX^ 


/6 


^ui^thJC^U 


(^}>u!!a/^>^ 


TTtPit^ 


JL 


J^tc£ou/)u -^ggyMS^i/A^ltryt^ 


,'y?'VG-yc6^^ j&Xjq/ ce>t;tdt/i;^ 


^^>c^feg/^^ 


f 


:l 


rl&jat C^rytstAc/ 


uryi^tkc:/' 


f 


J^ 


£^J),//tA^ 


6. 




%j/}Aq^ ^JUU 


cAdAy 


/^ 


.£a^. 


yylA^rrUU, 



/fi^r^:^, 



.4^rtc/(.LO^ 


L±c^ 


.Z 4C^ 


c^i/jLy 


■•'character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 
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Report 1 




CUSTOMER 

LIST 


Customer 

Contact 

Amount 

Representative 

Cactus Hardware 

Mr. 

Manual Shull 

$18,900.00 

Ortiz 

City College 

Mr. 

Robert Ries 

$67,300.00 

Jones 

City Services 

Ms. 

Suzanne Strayer 

$89,900.00 

Curtis 

Clinical Supply 

Mr. 

Donald Higgins 

$17,450.00 

Jones 

Community College 

Ms. 

Sharon Smith 

$235,980.00 

Ortiz 

Dareco Supply Co. 

Mr. 

Donald Smith 

$10,500.00 

Jones 

Farmers Association 

Mr. 

John Gaus 

$200,550.00 

Hull 

Farrington Co. 

Mr. 

Timothy Sainz 

$42,500.00 

Jones 

Global Industries 

Ms. 

Patricia Ross 

$28,000.00 

Hull 

Hospital Supply Co. 

Ms. 

Donna Ikeda 

$51,790.00 

Ortiz 

Johnson Manufacturing 

Mr. 

Samuel Smith 

$125,890.00 

Hull 

Mayan Construction 

Ms. 

Betty Smith 

$110,700.00 

Ortiz 

Ranchers Inc. 

Ms. 

Brenda Hebert 

$130,890.00 

Hull 

Rural Implements 

Ms. 

Judy Exline 

$26,000.00 

Hull 

State Pipe Co. 

Mr. 

Keith Cronin 

$60,000.00 

Curtis 

State University 

Ms. 

Pamela Ramage 

$54,900.00 

Ortiz 

Thompson Construction 

Ms. 

Betsy McKane 

$64,350.00 

Jones 

Tool Setting Co. 

Ms. 

Leslie Garland 

$32,780.00 

Jones 

Universal Industry 

Mr. 

Thomas Boyd 

$19,975.00 

Curtis 

Wrench Inc. 

Mr. 

Robert Arino 

$32,000.00 

Curtis 

TOTAL: $1,420,355.00 
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Report 1 
REPORT DESIGN WORKSHEET 


Report Preface 


Page Heading_ 


Record Group Definition 1 
Headings 


(Field Name) 


Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 


(Field Name) 


Report Summary 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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Report 1 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 












































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Report 1 


MATH INSTRUCTIONS 


REF. 
NO.'*^ 

VARIABLE NAME 
FOR ANSWER'"^-'V 

- - " 

FIRST 
NUMBER'V^v^v 

+ - -,v - 

SECOND 
NUMBEll-'V*'^ 

Ml 


= 




M2 


= 




M3 

« 

= 




M4 


= 




M5 


= 




M6 


= 




M7 


= 




M8 






M9 


= 




MIO 






Mil 


= 





"Enter Ref . No. on Report Design Worksheet at point of calculation 
""Maximum of 16 characters 

"""Field name, constant number, or variable name for answer of 
previous Math Instruction 


SUMMARY MATH INSTRUCTIONS 


REF. 
NO.-v 

VARIABLE NAME 
FOR ANSWER----V 

OPERATION"""" 

FIELD TO BE COMPUTED''""- 

SMI 




SM2 




SMS 




SM4 




SM5 




SM6 




SM7 





•Operations are Count, Average, Total, High, Low 
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Report 2 



REVENUE ANALYSIS BY INDUSTRY 



YEAR-TO- 

-DATE 1981 


INDUSTRY CUSTOMER 

AMOUNT 

TOTAL 

Bid 





Mayan Construction 

$110,700.00 



Thompson Construction 

$64,350.00 

$175,050.00 

Ed 





City College 

$67,300.00 



Community College 

$235,980.00 



State University 

$54,900.00 

$358,180.00 

Frm 





Farmers Association 

$200,550.00 



Ranchers Inc. 

$130,890.00 



Rural Implements 

$26,000.00 

$357,440.00 

Med 





Clinical Supply 

$17,450.00 



Dareco Supply Co. 

$10,500.00 



Hospital Supply Co. 

$51,790.00 

$79,740.00 

Mfg 





Cactus Hardware 

$18,900.00 



City Services 

$89,900.00 



Farrington Co. 

$42,500.00 



Global Industries 

$28,000.00 



Johnson Manufacturing 

$125,890.00 



State Pipe Co. 

$60,000.00 



Tool Setting Co. 

$32,780.00 



Universal Industry 

$19,975.00 



Wrench Inc. 

$32,000.00 

$449,945.00 

YEAR-TO- 

-DATE TOTAL 

$1,420,355.00 


LARGEST 

AMOUNT 

$235,980.00 


AVERAGE 

AMOUNT 

$71,017.75 


NUMBER OF CUSTOMERS 

20 



Reports 


11-41 


Report 2 
REPORT DESIGN WORKSHEET 


Report Preface_ 


Page Heading 


Record Group Definition 1 
Headings 


(Field Name) 


Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 


(Field Name) 


Report Summary 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math instructions . 
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Report 2 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 












































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Report 2 


MATH INSTRUCTIONS 


REF. 
NO.--"' 

VARIABLE NAME 
FOR ANSWER-'^--v 


FIRST 
NUMBER''-''--'^ 

+ - -:- . 

SECOND 
NUMBE1?-'>^"'V 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 




M7 


= 




M8 


= 




M9 


= 




MIO 


= 




Mil 


= 





"Enter Ref . No. on Report Design Worksheet at point of calculation 
""Maximum of 16 characters 

""'"Field name, constant number, or variable name for answer of 
previous Math Instruction 


SUMMARY MATH INSTRUCTIONS 


REF. 
NO . •'> 

VARIABLE NAME 
FOR ANSWER-'^-"- 

OPERATION"""" 

FIELD TO BE COMPUTED--"-- 

SMI 




SM2 




SMS 




SM4 




SMS 




SM6 




SM7 





"-""-"Operations are Count, Average, Total, High, Low 
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Report 3 



REVENUE ANALYSIS BY STATE 


STATE INDUSTRY 

REP 

REP TOTAL 

INDUSTRY TOTAL 


AZ 

Ed 

Jones 
Ortiz 

$67,300.00 
$54,900.00 

$122,200.00 


Frm 

Hull 

$156,890.00 

$156,890.00 


Med 

Jones 

$27,950.00 

$27,950.00 


Mfg 

Curtis 

Hull 

Jones 

$92,000.00 

$153,890.00 

$32,780.00 

STATE TOTAL 

$278,670.00 
$585,710.00 


CA 

Bid 

Jones 
Ortiz 

$64,350.00 
$110,700.00 

$175,050.00 


Ed 

Ortiz 

$235,980.00 

$235,980.00 


Frm 

Hull 

$200,550.00 

$200,550.00 


Med 

Ortiz 

$51,790.00 

$51,790.00 


Mfg 

Curtis 

Jones 

Ortiz 

$109,875.00 

$42,500.00 

$18,900.00 

STATE TOTAL 

$171,275.00 
$834,645.00 



REPORT SUMMARY 



NUMBER OF CUSTOMERS 


20 



YEAR-TO-DATE TOTAL 


$1,420,355 

00 
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Report 3 
REPORT DESIGN WORKSHEET 


Report Preface 


Page Heading_ 


Record Group Definition 1 
Headings 


(Field Name) 


Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 


(Field Name) 


Report Summary_ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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Report 3 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 












































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Report 3 


MATH INSTRUCTIONS 


REF. 

VARIABLE NAME 
FOR ANSWER''^''^ 


FIRST 

NUMBER'V--v--v 

+ - Vr - 

SECOND 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 




M7 


= 




M8 


= 




M9 


= 




MIO 


= 




Mil 


= 





"Enter Ref . No. on Report Design Worksheet at point of calculation 
"•'"Maximum of 16 characters 

'""Field name, constant number, or variable name for answer of 
previous Math Instruction 


SUMMARY MATH INSTRUCTIONS 


REF. 
NO.'"^ 

VARIABLE NAME 
FOR ANSWER-'"^ 

OPERATION-""-'"'"'"^ 

FIELD TO BE COMPUTED-""-'- 

SMI 




SM2 




SM3 




SM4 




SMS 




SM6 




SM7 





-"-"Operations are Count, Average, Total, High, Low 
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REVIEW ANSWERS 


Report 1 


REPORT DESIGN WORKSHEET 


Report Preface_ 


Page Heading_ 


UX^-^lZmtxC/Ly jCc.^^ 


C.«.aJt^m.eyi^ Cyyutaic^ Qyt^ei^^t^^ ^e.AyL&djcyyCXAZl't/^^- 


Record Group Definition 1 
Headings 


(Field Name) 


Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 

■^ CuAjtbyrvfy^Tl'a^rrUt^^ ■^^x^:U.-{/- /^ Fx/iq^ 'y/a^y*^'^ -^^t^^i^ yio^y^f-'^ 




Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 


(Field Name) 


Report Summary C\^A7 %. 


Ti-hJ^: -K>?^7^ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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Report 1 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 












































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

CcLi2orytfiyt-^ yj^fi-ryK^ 

(^LOW TO high)/ high TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Report 1 


MATH INSTRUCTIONS 


REF. 
NO.--'' 

VARIABLE NAME 
FOR ANSWER--'^--'' 

■ 

FIRST 
NUMBER*^''--'- 

+ . v.- . 

SECOND 
NUMBER--''''""' 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 




M7 


= 




M8 


= 




M9 


= 




MIO 


= 




Mil 


= 





"Enter Ref . No. on Report Design Worksheet at point of calculation 
"--'•'Maximum of 16 characters 

-■'"-'•'"Field name, constant number, or variable name for answer of 
previous Math Instruction 


SUMMARY MATH INSTRUCTIONS 


REF. 
NO.''^ 

VARIABLE NAME 
FOR ANSWER--'"-'-' 

OPERATION''-"-'"'"'' 

FIELD TO BE COMPUTED--'"'' 

SMI 

X^tsL 

r^^tu 

OP..L.My 

SM2 




SM3 




SM4 




SMS 




SM6 




SM7 





■*" "Operations are Count, Average, Total, High, Low 


Reports 
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Report 2 


REPORT DESIGN WORKSHEET 


Report Preface /\£/u-€/yi'Cut^ ^>t<iC/^^tf.t<a^' vi^, v»^<g^*et'Z^^ 


C/jt/M^'T^'jOa^ /9/y 


Page Heading 

y,Jl't>l.oCi>''Q^^tM <^!fct.<a^^tf>^'>-'<^^-^ //2'»»«'«*«^'>*^0 


-7^t^ 


Record Group Definition 1 yJLy^a^ (Field Name) 

Headings V- J2nv»(. -y^ 


Record Group Definition 2 
Headings ' 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Re cord G roup Summary 1 yJL/v^^^ 


(Field Name) 


•v-^^-^- 


Report Summary u5'/*^20 


^ (g^5^ 


C^ryi 3J (-S/rj 


J^2£^ 


-■/o- 


y v-cn/-€H>».^ 


^^j^yu^ait: z2„t^t««.»:t- ^■£^-¥- (luJ^,^MJ^ /^ly^^^x..^ -^ jlwlx^^S^-^- 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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Report 2 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 












































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

JUoL 


(m^ TO HIGH> HIGH TO LOW 

FIELD TO BE SORTED SECOND 

Cci42o?rte/l^ TZo/rrt^e— 

(UM TO high")/ HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Report 2 


MATH INSTRUCTIONS 


REF. 
NO.''' 

VARIABLE NAME 
FOR ANSWER--''* 


FIRST 
NUMBER'"'-'"'' 

+ - Vf - 

SECOND 
NUMBER''"'"'' 

Ml 


= 




M2 


= 




M3 


= 




M4 






M5 


- 




M6 


= 




M7 


= 




M8 


= 




M9 


= 




MIO 






Mil 


= 





'''Enter Ref . No. on Report Design Worksheet at point of calculation 
-•'"''Maximum of 16 characters 

-"-•'"''Field name, constant number, or variable name for answer of 
previous Math Instruction 



SUMMARY 

MATH INSTRUCTIONS 

REF. 
NO . -•'' 

VARIABLE NAME 
FOR ANSWER-'"'' 

OPERATION''"'"'"'' 

FIELD TO BE COMPUTED''"'' 

SMI 

Zk^ 

7S^ 

(yyu/e^ 

SM2 

i?f/£taJllt9!l6 

■7^^ 

^A^^ 

SM3 

^<^ 

4fyU>l/^ 

(PA/!^i/l^ 

SM4 
SMS 


QjUtJ^^^4XjCUl 

^Aa^a^ 

(2j(i<x^h;C^ 

^L^ 

C^&t^^^^i't^^t^ y^^fy^ru^^ 

SM6 




SM7 





''"'"'"''Operations are Count, Average, Total, High, Low 
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Report 3 


REPORT DESIGN WORKSHEET 


Report Preface_ 


/?.£>i^-€>KMx-^ U^t*'a^<^f>4yoa. -^ ^zixJ^ 


Page Heading 


Record Group Definition 1 ^^ (Field Name) 

Headings -V" ^T -V- 


Record Group Definition 2 '•o'^^v^ (Field Name) 

Headings -*^-JLn,JL-^ 


Record Group Definition 3 ^n/i-a^ ^Sfrjt*^ (Field Name) 
Headings ' 


Record Detail (what should print from each record) 


Record Group Summary 3 fjaJ-"-*^ /^fl^ (Field Name 

(fAn> -v^,g2tAa> /^^^9^ f -v^/6^-7^y^-i/- 


Re cord Group Summary 2 ^^I'y^-dL. (Field Name) 


Record Group Summary 1 ^1^ (Field Name) 


Report Summary C$^/^ fQ (^/!Z:^ 


^e^y^.tt'*^ 




^^^UA T^e^ V-y^.&^K^?^zt:^:^-t/^ 


fou can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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Report 3 


RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 

i 

ar 

^ AZ 1 'Cfl 









































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

^r 

(low' to hig^/ high to low 

FIELD TO BE SORTED SECOND 

JLy^^ 

<:;f0W~T0HIGH> HIGH TO LOW 

FIELD TO BE SORTED THIRD 

^a/^Cd^ /(j2y^ 

(;;IOW TOHIGg>/ HIGH TO LOW 

FIELD TO BE SORTED FOURTH 

/ 

LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 
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Report 3 


MATH INSTRUCTIONS 


REF. 
NO.* 

VARIABLE NAME 
FOR ANSWER-'''^ 


FIRST 
NUMBER-'^--'^--'^ 

+ - -;.- - 

SECOND 
NUMBER-'V'^''' 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 




M7 


= 




M8 


= 




M9 


= 




MIO 


= 




Mil 


= 





"Enter Ref . No. on Report Design Worksheet at point of calculation 
'"'Maximum of 16 characters 

"""Field name, constant number, or variable name for answer of 
previous Math Instruction 



SUMMARY 

MATH INSTRUCTIONS 

REF. 
NO.''' 

VARIABLE NAME 
FOR ANSWER-'"'' 

OPERATION-'"'"'""' 

FIELD TO BE COMPUTED'""'-" 

SMI 

AJZfi^-Mi/. 

7iti£ 

£u>6cyl^ 

SM2 

^^^4^6/ 

-ntc^ 

^.yi,96z^ 

SM3 

yO^dc^-^i&li 

-riJ^ 

^Adt^ 

SM4 

AC/as^ -A^^^ 

-r^t^i^ 

Sl/f6^ 

SMS 

/ 

^Atoft^C: 

^Uca:i^7n^e^ ?fa^r^*^e^ 

SM6 




SM7 





■"''""'Operations are Count, Average, Total, High, Low 
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CHAPTER SUMMARY 


A report can have up to six parts: 

1. a report preface prints once at the beginning of 
the report 

2. a page heading print after the report preface and 
at the top of each subsequent page in the report, 
up to the beginning of the report summary 

3. record group definitions 

— define the groupings (does not print) 

— can contain group headings and math 
calculations 

— must be used if a record group summary is 
used 

4. record detail prints information from each record 

5. a record group summary prints at the end of each 
group 

6. a report summary prints at the end of the report 

A report is a list sorted and grouped into meaningful 
units . It must: 

- have record group definition fields that define 
the groups 

- be sorted so that the first sort fields are the 
same as the record group definition fields 

A report can have up to three record group definition 
fields . 

A report can have both math calculations and summary 
math instructions. Summary math instructions 
calculate: 

- the total of a math field 

- the highest number in a math field 

- the lowest number in a math field 

- the average of a math field 

- the number of records in a group or report 

Additional functions that can be used with reports 
are: 

- select records for merging 

Reports 11-59 


- conditional text instructions 

— math instructions 

The Report Design Worksheet is used in this chapter. 
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Reports That Look Like Letters 


If you want to create a letter and use information from 
more than one record in that letter, you must create a 
report. A report can be made to look like a letter by 
typing: 

• the first part of the letter as a group heading in the 
record group definition 

• the information from the records as detail 

• the closing part of the letter as a record group 
summary 

(Each group summary must end with a required page end 
code so that each new group of records begins on a new 
page.) 

The IBM Displaywriter System Work Station Procedures 
Guide — Reportpack contains additional information about 
creating reports that look like letters. 

Figure 12-1 shows a report that looks like a letter. The 
report parts are marked. 


Reports That Look Like Letters 12-1 


■/Group Headingj^Supervisor/ 
August 3, 1982 


To: ¥Supervisor¥ 

From: George Alexander 

Re: Overdue Appraisals 

As you know, each employee should be appraised at least otice a year by 
his or her manager. The following is a list of employees whose 
appraisals are overdue* 


Naroe 


tte of Last Appraisal 


/Record Detail/ 

¥First_Name¥ ¥MI¥ ¥LastJfame¥ ¥App_Date¥ 

/Group Summaryj5_Supervisor/ 

Please handle these meetings as soon as possible, Kotify the Personnel 
Department of the employee's name, appraisal level, and appraisal date. 



jy August 3, 1982 

rs 

To: Barbara Wilson 

From: George Alexander 

Re: Overdue Appraisals 

As you know, each employee should be appraised at least once a year by 
his or her manager. The following is a list of employees whose 
appraisals are overdue. 



Name 

Roger T. Norton 
Helen K. Morgan 
Carol A. Fisher 
Marilyn L. Velasco 
Maxwell A. Madison 
George J. Steiniger 
Wa] ter M. Smith 
David Y. Clark 


Date of Last Appr aisal 

79/12/30 
80/07/24 
80/10/15 
80/10/30 
80/11/28 
80/12/15 
81/01/15 
81/02/05 


Please handle these meetings as soon as possible. Notify the Personnel 
Department of the employee's namie, appraisal level, and appraisal date. 


Figure 12-1 (Part 1 of 2). Report Designed to Look Like a Letter 
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REPORT DESIGN WORKSHEET 


Report Preface_ 


Page Heading_ 


Record Group Definition l ^M'fUA4r<4.^f-i^ (Field Name) 
Headings CL<. ^.*^^*^ 3. /^^Z- * m 9 


/lOt^ytJtL. 


Record Group Definition 2 
Headings 


Mejtaiatfy&ct' CUt^iA'A^U^ 


(Field Name) 


Record Group Definition 3 
Headings ■ 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1; : ,^<i^tg<tt4rca.j i ^ (Fi 


eld Name) 

pU^ ^a.a^-iB'J'^' ••■a^*^.- 


Report ;Summary_ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


Figure 12-1 (Part 2 of 2). Report Designed to Look Like a Letter 
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REVIEW QUESTION 


Using the information from the File Design Worksheet 
below, complete the Report Design Worksheet on the 
following page so that a report that looks like a letter 
is sent to every sales representative listing his or her 
customers and orders . 


FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
TYPE* 


NUMBER OF 
CHARACTERS'' 


COMMENTS 


(y//Ct/bntA.y ^iLfnij 


c/a/L, 


A^ 


Cgyrt 



X6 


^UiOatu 


^t^iayyrULj 


/S 


.aAt-Zij ' MXJL^ a£A^iM/zAieiA.<rn^ 


y^^L^ 


ytt^t/jL a^ C/ryi:6lc/ yiMA^fiS^^^ 


fMtJoot yfOanJu 


/O 


>ni 


.z/yLc/uu/t^ .yQju/r^^Ci3x/ocCtca>t^ 


d^dAU ^^4t/tttju 


/5 


^uA^iivtA. 


<^^t-^^/^ 


2a« 


^ 


^t^rtc£eju/tj ^JilU/itcy ' ^ ^^L/m 


^yrt/rrctX^a^ J^ouq/' Ca>tj6sije:/ 


^^ttJAJ^A 


6ryvlkc/- 


f 


^..£uii' c^ytXiLc/ 


^ 


.^ 


^a/^Caa^ 






^g/t-d^ ^fxr 


cAmj 


/^ 


Ja^. 


-^ytA/rrtx^ 




/fV r.yy., 



a^tvc/u^o^Ll. 


yytt/ 


.^.laa^ c^aCjLy 


''•character field 
math field 
text field 


** 1-80 characters 
1-17 characters 
1-500 characters 
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REPORT DESIGN WORKSHEET 


Report Preface 


Page Heading_ 


Record Group Definition 1 
Headings 


(Field Name) 


Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 


(Field Name) 


Report Summary_ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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REVIEW ANSWER 


REPORT DESIGN WORKSHEET 


Report Preface_ 


Page Heading_ 


Record Group Definition 1 yCi/e^u ^^^ (Field Name) 
Headings -Ta : V" /^ -Ti'^^T^ -J^^o^^M^ >^^y 


^^i tf*^ ^-drt^^^^^ 


}^^Ut.i*^A't^ 




Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 
•>^ Cuui^te^'v^jtyL^ TTgyT^JZ.-^ ■V^^A.d^.^'^ 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 ^QjLc^ ^jzjay (Field Name) ^ 

*Ji}^ "^f^i*^ yuitA^ ^Z»i^^ <U<^^^^£«>^■<^^^^ ^^.^:^.>ize {Z^i£f 


:^*t^ 


Report Summary_ 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 


12-6 


To: Ms. Jones 

From: James Johnson, Sales Manager 

Re: 1981 Sales 


As we come to the closing quarter of the year, I'd like to give you a 
clear picture of your sales in 1981. The following is a list of your 
customer and their orders. 

Dareco Supply Co. $10,500.00 

Farrington Co. $42,500.00 

Tool Setting Co. $32,780.00 

City College $67,300.00 

Thompson Construction $64,350.00 

Clinical Supply $17,450.00 

If you have any questions, please call me. 


Reports That Look Like Letters 12-7 


This page intentionally left blank. 


12-8 


CHAPTER SUMMARY 


To create a letter that uses information from more 
than one record, you must do it as a report. 
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File Lists 


A list is a type of report which has fields from all 
selected records merged with a shell document to produce 
one output document . 


SINGLE COLUMN FILE LISTS 


To print a list that has a single set of columns, such as 
the one in Figure 13-1, you print it as a report using 
only the page heading and record detail instructions. 
Because this is simply a report, it can have math 
instructions . 

A single column file list is created by using a Report 
Design Worksheet. This is the same worksheet that you 
used in Chapter 11. 
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Name 

Extension 



Wilson, 
Young, 

Frank P. 1839 






Name 

Extension 


Acker, Michael F. 

3849 


Anderson, Peggy L. 

4579 


Benson, Karen J. 

4567 


Black, Theresa H. 

8493 


Boswell, Dorothy P. 

3728 


Boyle, Lorna A. 

2736 


Bradley, Richard J. 

2734 


Burns, Sue R. 

2938 


Carrigan, Simon E. 

3879 


Chapman, Lorna J. 

8293 


Clark, David Y. 

8293 


Crawford, Ronald G. 

5736 


Davidson, Jean T. 

6483 


Fisher, Carol A. 

5647 


Fisher, Victor P. 

7874 


Forrest, Rachel L. 

4958 


Garcia, Ralph R. 

3684 


Goodman, Debbie S. 

6789 


Hunt, Allen K. 

8394 


Jackson, Thomas W. 

2837 


Kahn, Cecelia B. 

2838 


Kelly, Laverne W. 

2839 


Knight, Roger H. 

9087 


Kramer, Roger P. 

2273 


Lambert, Stanley R. 

5483 


Lee, Cynthia R. 

2837 


Lopez, Robert M. 

3782 


Madison, Maxwell A. 

3956 


Martin, Jeff D. 

3856 


Morgan, Helen K. 

2583 


Nelson, Mavis Y. 

8293 


Nelson, Patricia H. 

5434 


Norton, Roger T. 

2837 


Ostrom, Gerald S. 

1726 


Ostrom, James R. 

3847 


Park, Trisha J. 

3948 


Perkins, Sherry J. 

3553 


Perry, Tracy S. 

2839 


Preston, Diane K. 

3894 


Rogers, Brian K. 

7462 


Schultz, Lisa G. 

5839 


Shaw, Pauline F. 

5840 


Smith, Walter A. 

5938 


Smith, Walter M. 

3874 


Steiniger, George J. 

8379 


Swanson, Simon E. 

5849 


Tweeden, Nancy W. 

8293 


Velasco, Marilyn L. 

4958 


Velasco, Michael L. 
White, Barbara N. 

2748 
5394 



VJhite, Jack E. 

3868 


Wilson, Barbara J. 

2647 


Figure 13-1. Single Column List 
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MULTI-COLUMN FILE LISTS 


A multi-column file list can be printed with two to eight 
sets of columns of information with headings at the top of 
each set of columns. The list shown in Figure 13-2 has two 
sets of columns. 

A Multi-Column File List Worksheet is used to design a 
multi-column list. On the worksheet, you need to indicate 
the: 

• number of sets of columns 

• width of each set of columns 

• headings 

• fields to be used 

You'll learn more in this chapter about how to set up 
multi-column file lists. 
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Name 

Acker, Michael F. 
Anderson, Peggy L. 
Benson, Karen J. 
Black, Theresa H. 
Boswell, Dorothy P 
Boyle, Lorna A. 
Bradley, Richard J, 
Burns, Sue R. 
Carrigan, Simon E. 
Chapman, Lorna J. 
Clark, David Y. 
Crawford, Ronald G, 
Davidson, Jean T. 
Fisher, Carol A. 
Fisher, Victor P. 
Forrest, Rachel L. 
Garcia, Ralph R. 
Goodman, Debbie S. 
Hunt, Allen K. 
Jackson, Thomas W. 
Kahn, Cecelia B. 
Kelly, Laverne W. 
Knight, Roger H. 
Kramer, Roger P. 
Lambert, Stanley R, 
Lee, Cynthia R. 
Lopez, Robert M. 
Madison, Maxwell A, 
Martin, Jeff D. 
Morgan, Helen K. 
Nelson, Mavis Y. 


Extension 

Name 

Extension 

3849 

Nelson, Patricia H. 

5434 

4579 

Norton, Roger T. 

2837 

4567 

Ostrom, Gerald S. 

1726 

8493 

Ostrom, James R. 

3847 

3728 

Park, Trisha J. 

3948 

2736 

Perkins, Sherry J. 

3553 

2734 

Perry, Tracy S. 

2839 

2938 

Preston, Diane K. 

3894 

3879 

Rogers, Brian K. 

7462 

8293 

Schultz, Lisa G. 

5839 

8293 

Shaw, Pauline F. 

5840 

5736 

Smith, Walter A. 

5938 

6483 

Smith, Walter M. 

3874 

5647 

Steiniger, George J. 

8379 

7874 

Swanson, Simon E. 

5849 

4958 

Tweeden, Nancy W. 

8293 

3684 

Velasco, Marilyn L. 

4958 

6789 

Velasco, Michael L. 

2748 

8394 

White, Barbara N. 

5394 

2837 

White, Jack E. 

3868 

2838 

Wilson, Barbara J. 

2647 

2839 

Wilson, Frank P. 

1839 

9087 

Young, Gloria F. 

3847 

2273 



5483 



2837 



3782 



3956 



3856 



2583 



8293 




Figure 13-2 (Part 1 of 2) . Sample Multi-Column File Name and Address List 
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MULTI-COLUMN FILE LIST WORKSHEET 


1. Number of Sets of Columns (2-8) [2] 


2. Column Width of Each Set (3-284) (401 


^O 


3. Column Headings 


T^O/Tyve^ 


C^^fClc^yvOA.^<rrt^ 


4. Field Names 


/, 


S-<i&^ y^O'^-^^y ^^:7}'U<^ 


Note: Numbers in parentheses following each item are range of choices. The number 
in brackets following each item is the system default. 

You can also use the following worksheets with this worksheet: 

• Record Selection Specifications 

• Sort Specifications 


SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 

^0^ ytat^^^yjz^ 

(jm TO HIGH)/ HIGH TO LOW 

FIELD TO BE SORTED SECOND 

^::^yy^a^ '^<Clyy,^,4- 

(fLOW TO HIG^)/ HIGH TO LOW 

FIELD TO BE SORTED THIRD 

mr 

(LOW TO HIGH)/ HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


Figure 13-2 (Part 2 of 2). Sample Multi-Coluran File Name and Address List 


File Lists 
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Determining Column Width 


To create a multi-column file list, you need to determine 
the number of sets of columns you want and the width of 
each set of columns . The width of a set of columns is the 
total amount of space necessary to print the fields from 
one record plus the amount of white space you want between 
set of columns. Figure 13-3 shows what we mean by the 
width of a set of columns (we'll call it column width). 

To determine how wide a set of columns should be, add: 

1. the maximum field length for each field that will be 
printed 

2. the amount of space you want between the fields 

3. the amount of space you want between the sets of 
columns 

Note: You specify the column width for only one set of 
columns because the system automatically repeats that 
information for the other columns. 
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Name 

Extension 

Name Extension 


Acker, Michael F. 

3849 

Nelson, Patricia H. 5434 


Anderson, Peggy L. 

4579 

Norton, Roger T. 2837 


Benson, Karen J. 

4567 

Ostrom, Gerald S. 1726 


Black, Theresa H. 

8493 

Ostrom, James R. 3847 


Boswell, Dorothy P. 

3728 

Park, Trisha J. 3948 


Boyle, Lorna A. 

2736 

Perkins, Sherry J. 3553 


Bradley, Richard J. 

2734 

Perry, Tracy S. 2839 


Burns, Sue R. 

2938 

Preston, Diane K. 3894 


Carrigan, Simon E. 

3879 

Rogers, Brian K. 7462 


Chapman, Lorna J. 

8293 

Schultz, Lisa G. 5839 


Clark, David Y. 

8293 

Shaw, Pauline F. 5840 


Crawford, Ronald G. 

5736 

Smith, Walter A. 5938 


Davidson, Jean T. 

6483 

Smith, Walter M. 3874 


Fisher, Carol A. 

5647 

Steiniger, George J. 8379 


Fisher, Victor P. 

7874 

Swanson, Simon E. 5849 


Forrest, Rachel L. 

4958 

Tweeden, Nancy W. 8293 


Garcia, Ralph R. 

3684 

Velasco, Marilyn L. 4958 


Goodman, Debbie S. 

6789 

Velasco, Michael L. 2748 


Hunt, Allen K. 

8394 

White, Barbara N. 5394 


Jackson, Thomas W. 

2837 

White, "Jack E. 3868 


Kahn, Cecelia B. 

2838 

Wilson, Barbara J. 2647 


Kelly, Laverne W. 

2839 

Wilson, Frank P. 1839 


Knight, Roger H. 

9087 

Young, Gloria F. 3847 


Kramer, Roger P. 

2273 



Lambert, Stanley R. 

5483 



Lee, Cynthia R. 

2837 



Lopez, Robert M. 

3782 



Madison, Maxwell A. 

3956 



Martin, Jeff D. 

3856 



Morgan, Helen K. 

2583 



Nelson, Mavis Y. 

1 

1 

1 

8293 
. J 


J 


C&€co^yrt,yyx^ ^ 


■iknaU:^ 

-Urtc^^^ 



Figure 13-3. Multi-Column File List With Column Width Marked 


File Lists 
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ADDITIONAL FUNCTIONS YOU CAN USE WITH LISTS 


You can use any function with a single column file list 
that you would use with a report. See the "Additional 
Functions" in Chapter 11. 

You can use several of the functions already discussed 
with multi-column file lists. You can: 

• sort the records 

• select the records 

• use conditional text instructions 

Any conditional text used in a multi-column file list 
must be no longer than one line. 

You cannot use math calculations or text fields in a 
multi-column file list. 
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REVIEW QUESTION 


Using the file information from the File Design Worksheet 
shown below, fill out the Multi-Coluran List Worksheet on 
the next page so that a three- column customer name and 
address list is printed. There are no column headings. 


FILE DESIGN WORKSHEET 


FIELD NAME 


FIELD 
XYPE'V 


NUMBER OF 
CHARACTERS'" 


COMMENTS 


(/^c Xd fnjUs^ y^a ^TU^ 


cAnK f 


JZ^ 


j^a^ 


LQ^il. 


X6 


Carruhifice 


i^t'ia^yrULJ 



/S 


XH^2jE ^ '^^oQ A^ a ^^iA^ Z^<-A^i<R^ 


-ZitA. 


y^JtA. fg<gf>g^^Zg/^<ai/UxtfVC^ 


fMoid y^O/mju 


/O 


>n^ 


x/i^jcjLu/i-. ^ajtAyrU!i7Loct:^ltri^ 


c^dUoT ^fO/yytJ^ 


/5 


^uJ UiJC^ 


(^s>v<^A6f r?^ 


zzie^A^ 


X 


J^^cAcaOu ^ Jy^^t(/^A<n^ 


y^y7t.er>ij6^<t^ j&Ui/' ce-yc^Sjc:/ 


^^fkCtjj^y-A 


If 


rJaxut <Ur>tXgt/i:^ 


&yvilkc/- 


f 


J^ 


£^J>^/jtA^ 






Ssi/fAfLf /(jjoj 


sAaLl. 


/^ 


A^. 


yylA/rrt»^ 



/>Lf. r.:^A. 



A'TvdUce^ 


yrta^ 


Ji^'Q*^ 


CoaOuf 


"Character field 
math field 
text field 


"* 1-80 characters 
1-17 characters 
1-500 characters 
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MULTI-COLUMN FILE LIST WORKSHEET 


1. Number of Sets of Columns (2-8) [2] 


2. Column Width of Each Set (3-284) [40] 

3. Column Headings 


4. Field Names 


Note: Numbers in parentheses following each item are range of choices. The number 
in brackets following each item is the system default. 

You can also use the following worksheets with this worksheet: 

• Record Selection Specifications 

• Sort Specifications 
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REVIEW ANSWERS 


MULTI-COLUMN FILE LIST WORKSHEET 


1. Number of Sets of Columns (2-8) [2] 


2. Column Width of Each Set (3-284) [40] ^O C^^y^g^ag^ygw^ <»»*^ 

3. Column Headings 


-yzcrytO- 


4. Field Names 




Note; Numbers in parentheses following each item are range of choices. The number 
in brackets following each item is the system default. 

You can also use the following worksheets with this worksheet: 

• Record Selection Specifications 

• Sort Specifications 
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CHAPTER SUMMARY 


A single column file list is done as a report. 

A multi-column file list can have two to eight sets of 
columns with headings . 

Column width is calculated by adding: 

— the field widths 

— the space between the fields 

— the space between the columns 

Additional functions that can be used with 
multi-column lists include: 

— sorting records 

— selecting records 

— using conditional text (no longer than one line) 
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Evaluating And Correcting File Problems 


Once you have read this guide, you can begin to design and 
use your own files. Not everything may work right the 
first time. This chapter is designed to help you identify 
and correct any problems. 

DO A DESIGN CHECK FIRST 

To test your file design, create a small file of 
approximately 20 representative records. Then, create all 
the shell documents that you will use and merge these with 
the 20-record file. Often this procedure will help you 
identify any design problems before you expend a lot of 
time and effort creating a large file. 

HOW YOU CAN DETERMINE THE CAUSE OF A PROBLEM 

If you have problems, go through the following procedure. 

1. Is the file designed correctly? Are the field types 
correct? Did you include all the necessary fields? 
Are there any of the problem fields identified in 
Chapter 3? If the file was designed correctly, go to 
the next area. 

2.. Look at the shell document you created. Are there any 
error messages? If there are, the IBM Displaywriter 
System Prompts and Messages Guide — Textpack 
4/Reportpack indicates when a message might occur and 
actions you can take. In addition, if you specify 
that the system continue processing the job even if 
it finds an error (Cancel on Error = No), the error 
message will print at the point where the error 
occurred. 

3 . Review the worksheets and determine whether you 
filled them out correctly. 

4. Finally, review what was typed to assure yourself 
that the worksheets were correctly transferred to the 
IBM Displaywriter. Stored setups are particularly 
helpful here because you can check exactly what was 
typed. 

After you've checked all the potential problem areas, 
rerun the application. If problems still exist, call 
your IBM Marketing Support Representative. 
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Blank Worksheets 


This appendix contains blank worksheets for your use. 
Make copies, as you need them, to use as you design your 
files and your output documents. 
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FILE DESIGN WORKSHEET 


FIELD NAME 

FIELD 
TYPE'V 

NUMBER OF 
CHARACTERS'V^v 

COMMENTS 


























































































"Character field 
math field 
text field 


" 1-80 characters 
1-17 characters 
1-500 characters 
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MATH FORMATS WORKSHEET 


ITEM 

FORMAT 1 

FORMAT 2 

FORMAT 3 

FORMAT 4 

Character for 
Decimal 

comma 
colon 

period 

comma 
colon 

comma 
colon 

comma 
colon 

Character for 
Thous ands 
Separator 

period 

cottar 
req. space 
none 

period 

req. space 
none 

period 

req. space 
none 

period 
comma 
req. space 

Number of 
Characters to 
Right of Decimal 

0-15 

1:1 _ 

0-15 

0-15 

':<ii _ 

0-15 
1 _ 

Rounding Rule 

l-sX, 6-9t 
1-94. 
l-9t 
none 

WMmWm 

1-54., 6-9t 
1-94. 
l-9t 
none 

1-54., 6-9t 
1-94. 
l-9t 
none 

1-54., 6-9r 
1-94. 
l-9t 
none 


Text (any eight characters) 


Preceding 
Positive Number 
or Zero 

imp, ''text 

f 

m t^xt 

'«{>:■■ t«xt 

Following 
Positive Number 
or Zero 

%p>-t^Xt: 

no t i^jct 

po text 

mtmM 

Preceding 
Negative Number 

:-,:■ (minus) 

-$ 

- (minus) 

~ (minus) 

Following 
Negative Number 

iO::|i«2tSt::;. 

'tMiZ-trnt" 

miM0M 

^i?o t«ict 


Your Notes 


Example of 
This Format" 

illii 

M&m 

25 

^zmm 

This Format 
Used For 

money** 

^w^^iM^ 

.li^il 

llliii 


"Example uses the positive number 25 
'''"Add $ in text 
-vVf-.VQrade Point Average 
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MATH INSTRUCTIONS 


REF. 
NO.* 

VARIABLE NAME 
FOR ANSWER** 


FIRST 

NUMBER*** 

+ - ^v - 

SECOND 
NUMBET?*** 

Ml 


= 




M2 


= 




M3 


= 




M4 


= 




M5 


= 




M6 


= 




M7 


= 




M8 


= 




M9 


= 




MIO 


= 




Mil 


= 





'Enter Ref . No. on Report Design Worksheet at point of calculation 
'*Maximum of 16 characters 

'**Field name, constant number, or variable name for answer of 
previous Math Instruction 


SUMMARY MATH INSTRUCTIONS 


REF. 
NO.* 

VARIABLE NAME 
FOR ANSWER** 

OPERATION**** 

FIELD TO BE COMPUTED** 

SMI 




SM2 




SM3 




SM4 




SM5 




SM6 




SM7 





'***Operations are Count, Average, Total, High, Low 
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MULTI-COLUMN FILE LIST WORKSHEET 


1. Number of Sets of Columns (2-8) [2] 


2. Column Width of Each Set (3-284) [40; 

3. Column Headings 


Field Names 


Note: Numbers in parentheses following each item are range of choices. The number 
in brackets following each item is the system default. 

You can also use the following worksheets with this worksheet: 

• Record Selection Specifications 

• Sort Specifications 
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REPORT DESIGN WORKSHEET 


Report Preface_ 


Page Heading 


Record Group Definition 1 
Headings 


(Field Name) 


Record Group Definition 2 
Headings 


(Field Name) 


Record Group Definition 3 
Headings 


(Field Name) 


Record Detail (what should print from each record) 


Record Group Summary 3 


(Field Name 


Record Group Summary 2 


(Field Name) 


Record Group Summary 1 


(Field Name) 


Report Summary 


You can use the following worksheets with the Report Design Worksheet: Record 
Selection Specifications, Sort Specifications, Math Instructions, and Summary 
Math Instructions. 
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RECORD SELECTION SPECIFICATIONS 


SELECTION 
LINE 

FIELD 

SELECTION CRITERIA 












































SORT SPECIFICATIONS 



FIELD NAME 

KIND OF SORT 

FIELD TO BE SORTED FIRST 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED SECOND 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED THIRD 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FOURTH 


LOW TO HIGH / HIGH TO LOW 

FIELD TO BE SORTED FIFTH 


LOW TO HIGH / HIGH TO LOW 


Blank Worksheets 
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Character Sort Chart 


The sort chart on the following page shows the sorting 
order that the system uses. It is arranged from 
low-to-high, so that a space would also be the first 
character and a three superscript would be the last. A 
high-to-low sort would be done in the opposite order. 

A space (SP) , a syllable hyphen (SHY), and an apostrophe 
(') are ignored during a sort. 

Note: Upper and lower case alphabetic characters are 
sorted as through they were the same character. For 
example, if you were to sort "abadaba" and "Abadaba," 
abadaba would sort first if the record containing it were 
added to the file before the record containing Abadaba. 
Otherwise, the capitalized version would be placed before 
the lower case version. 
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Character 

Title 

Character 

Title 

RSP 


Required Space 

f 

or 

F 


[ 



Opening Bracket 

g 

or 

G 





Period 

h 

or 

H 


< 



Less Than 

i 

or 

I 


( 



Open Parenthesis 

k 

or 

K 


+ 



Plus 

1 

or 

L 





Exclamation Mark 

m 

or 

M 


& 



Ampersand 

n 

or 

N 


] 



Closing Bracket 

o 

or 




$ 



Dollar 

P 

or 

P 


-V 



Asterisk 

q 

or 

Q 


) 



Close Parenthesis 

r 

or 

R 


J 



Semicolon 

s 

or 

S 


- 



Minus /Hyphen 

t 

or 

T 


/ 



Slash/Division 

u 

or 

U 


1 



Vertical Line 

V 

or 

V 


3 



Comma 

w 

or 

W 


% 



Percent 

X 

or 

X 





Underscore 

y 

or 

Y 


> 



Greater Than 

z 

or 

Z 


7 



Question Mark 

NSP 


Numeric Space 




Colon 





Zero 

/^ 



Number Sign 

1 



One 

@ 



At Sign 

2 



Two 

= 



Equal 

3 



Three 

It 



Quotation Mark 

4 



Four 

± 



Plus/Minus 

5 



Five 





Degree 

6 



Six 

«t 



Cent Sign 

7 



Seven 

Va 



One Quarter 

8 



Eight 

V2 



One Half 

9 



Nine 

% 



Three Quarters 

2 



Two Superscript 

= 



Double Underscore 

3 



Three Superscript 

a 

or 

A 






b 

or 

B 






c 

or 

C 






d 

or 

D 






e 

or 

E 
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Converting Text Into Records 


CONVERSION RULES 


You must provide some conversion information for the 
system before converting the text. This information can 
be divided into four parts. 

1. You must specify at least one record separator 
character that marks the end of each record (a 
required carrier return, for example), and you can 
specify two different record separator characters. 

When the system finds a record separator character 
while it is reading text during a conversion process, 
it ends the record at that point and begins a new 
record. 

Unless you specify otherwise, the system assumes that 
any required carrier return is a record separator 
character . 

2. You must specify at least one field separator 
character that marks the end of each field (such as a 
tab) , and you can specify two different field 
separator characters. 

The system reads the text until it finds a field 
separator. Then it places all the information up to 
that point in the first field of the record after the 
Displaywriter Record ID. The system continues 
reading the text until it finds another field 
separator character. It places all the text located 
between the end of the first field and the field 
separator in the second field, and so on, until the 
system finds another record separator character. 

There are two additional considerations in specifying 
the field separators: 

a. The two characters that you use for field 
separators cannot be used within a field, because 
the system reads them as field separators and 
assumes that they mark the end of that field. 

b. Neither of the two characters used for the field 
separators can be the same as either of the two 
characters used for record separators. 
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Unless you specify otherwise, the system assumes that 
the two field separators are a tab and an index 
return. (Those are the field separators on an IBM 
Office System 6.) 

You can specify a comment begin character. The 
comment begin character marks the beginning of 
information to be treated as a comment and not to be 
converted as a file field. If, for example, you are 
converting a table that was typed as text, you want 
the entries in the table to be converted into file 
fields. However, you do not want the table headings 
to be a part of the file. To prevent this, you would 
indicate that the table headings are a comment. 

The comment begin character must always be at the 
beginning of a document or following a record 
separator. The system reads all information as a 
comment from the comment begin character up to, and 
including, one of the following characters: 


carrier return 

required carrier return 

index return 

zero index return 

page end 

required page end 

line format change 

return to master line format 


Immediately following the comment text, either a new 
comment may begin (if another comment begin character 
is found) or the first field is started. If a comment 
begin character is anywhere other than at the 
beginning of the text in the source document or 
immediately following a record separator character, 
the system treats it as a regular character. 

Unless you specify otherwise, the system assumes that 
the comment begin character is a required space. 

You can specify whether the first field in each source 
record is to be used in the Displaywriter file. For 
records developed on the IBM Office System 6, for 
example, the first field is a Record ID field. 
Because the Displaywriter assigns its own Record IDs, 
the Record ID from the original file is not needed. 
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CONVERSION CONSIDERATIONS 


The text must meet certain requirements before it can be 
converted into a file. The characters that will be used 
for separating the text into fields and records must be 
consistent. If your field separators are tabs and index 
returns, for example, each field in the text must be 
separated by them and no other character. 


Common Conversion Problems 


Look at the text to determine if there are any characters 
that violate the file's field descriptions. These two 
problems are common: 

1. An word underline character can only be placed in a 
text field. It cannot be used in a math or character 
field. 

2. Only numbers, a decimal point, and a plus or minus 
sign can be used in a math field. If the number text 
has a $ or commas separating the thousands, they must 
be deleted before conversion. 

Notice how the text information is arranged. If you 
convert the named-variable list in Figure C-1, the title, 
first name, and last name are placed in one field. The 
city, state, and zip code are also placed in one field. 
You may want to edit the text before converting it if it 
doesn't match your file design. 

In addition, other considerations related to specific 
types of text documents are discussed in the following 
section. 
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Converting Name-variable Lists 


If the text is a named-variable list, such as the one in 
Figure C-1, the same variables must appear in every list, 
and each variable must always be in the same order. 
During the conversion process, the system ignores the 
variable names and simply reads the variable values into 
the records in the same order that the values appear in 
the list. 

If variables are missing from a list or are not always in 
the same order, the records will not convert properly. 


Vtodays_dateVAugust 18, 1981 
VnameVMrs. Renee Taylor 
Vinside_ac]dressVl876 Saleri Avenue 
Austin, Texas 78734 
Vcredit_liniitVl,000.00 
VsignatureVP. A. Payne 


Rec ID date 

name 

inside address 


credit limit 

signature 

1 August 

18, 1981 Mrs. Renee Taylor 

1876 Salem Avenue | 

Austin, Texas 

78734 

1000.00 

P. A. Payne 


Figure C-1. Named-variable List and File Entries 
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Converting Switch-code Lists 


If the text is a switch -code list such as the one in 
Figure C-2, each group of values that is to be a record 
must end with a unique control character that does not 
appear elsewhere in the group of variables. You may have 
to edit the list before conversion and add a control 
character, such as a carrier return, to mark the end of 
each record. 


August 18, ]981Hrs. Renee Taylor 1876 Salem Avenue 

Austin Texas 787341 1 , 000. OOP. A. PayneAugust 18, 1981Mr. Douglas 

Kyle 1200 Blair Road 

Austin, Texas 7877Mr. Kyle750.00P. A. PayneAugust 20, 1981Mrs. K. S. 

Meycrsl980 Lonsdale CircleSt. Louis, Texas 78759Mrs. Meyers2,000.00L. R. 

Penny 


Rec ID 

date 



name 



inside 

address 






credit 

limit 

signature 




1 

August 

18, 

1981 

Mrs. 

Renee 

Taylor 

1876 Sa 

leiTi Avenue 





Austin, 

Texas 

787-34 





1000, OC 


P. A 

. Payne 





Figure C-2. Switch Code List and File Entries 
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Converting Text Tables 


If the text is a table, such as the one in Figure C-3, the 
entries on each line must be separated by a tab so that 
each entry is in a separate field. Each line must be 
ended by the same character, such as a carrier return or 
required carrier return, if each line is to be a record. 


Current 

695,441 
200,756 
150,442 
879,881 


1980 


1979 


1978 


719,343 

653,948 

602,344 

453,971 

163,487 

154,773 

512,111 

131,162 

129,761 

398,356 

723,325 

482,609 


Rec ID Current 


695441 
200756 
150442 
879881 


For 1980 For 1979 For 197! 


719343 
453971 
512111 
398356 


653948 
163487 
131162 
732325 


602344 
154773 
129761 
482609 


Note: Commas were deleted prior to conversion and the table heads 
were dropped during the coversion. The field names were assigned 
when the file description was created. 

Figure C-3, Text Table Converted to File Entries 


Converting the Text to a File 

Once the text in the source document is ready, you can 
convert it into a file. To convert a document, you must 
have a source document, a destination file with field 
descriptions, and an error document. 

The error document stores any text that could not be 
successfully converted from the source document into the 
destination file. You can look at the information in the 
error document after completing the conversion process 
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and correct any problems. After the problems are 
corrected, you can convert the text from the error 
document into a file. 
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Glossary 


The following terms are defined as 
they are used in this book. For other 
items, refer to the IBM Data 
Processing Glossary , GC20-1699. All 
terms marked with an asterisk (-'") are 
from the American National 
Dictionary for Information 
Processing . 

IBM is grateful to the American 
National Standards Institute (ANSI) 
for permission to reprint its 
definitions from the American 
National Dictionary for Information 
Processing (Copyright (c) 1975 by the 
American National Standards 
Institute, Inc.), which was prepared 
by Subcommittee X3K5 on Terminology 
and Glossary of American National 
Standards Committee X3 . 

-h. A symbol marking the beginning 
and end of an instruction, such as a 
math instruction, in a shell 
document . 

*¥•: A symbol marking the beginning 
and end of a variable in a shell 
document. If the variable is 
followed by a number, the number is 
the number of the math format to be 
used. 

carrier return: The function of 
moving the printer element to the 
left margin of the next line. 

character: A letter, digit, or other 
symbol used as part of the 
organization, control, or 
representation of data. 

character field: A type of file field 
that can contain either alphabetic or 
numeric characters . 


conditional text: Text that is 
printed based on the existence or 
non-existence of an entry in a field. 

control character: A non-printing, 
word processing character, such as a 
tab or carrier return, used to format 
text . 

count: The function of counting the 
number of records meeting a set of 
selection criteria. 

default: A value, attribute, or 
option that is preassigned and 
assumed by a system when no other has 
been specified by the operator. 

delete: The function of erasing a 
record or records . 

destination file: During the 
duplication of a file, it is the file 
that records are copied to. 

diskette: A thin, flexible, magnetic 
disk and its semirigid, protective 
jacket, in which the diskette is 
permanently enclosed. It provides 
reusable storage of documents that 
can be used and updated. 

document: A collection of one or 
more lines of text that can be named 
and stored as a separate entity. 

duplicate: To copy information from 
a location, leaving the information 
at that location unchanged, and to 
move the copy to another location. 

field: One piece of information in a 
record; for example, the first name 
of a person. A record is made up of 
fields . 


complete record: 

fields filled in. 


A record with all 


field name: An operator-assigned 
name for a field in a file. 
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field type: A definition of a field 
based on the type of characters that 
can be typed into the field. Can be 
character, math, or text. 

file: A collection of related 
information. For example, a 
personnel file may consist of the 
information found in personnel 
folders . 

format: A set of specific conditions 
that determine the final position of 
text on a page . 

function keys: Special keys that do 
not produce characters for printing 
when they are used, but allow the 
operator to give instructions to the 
system for additional functions. 

group: A subdivision of records 
within a report. All records in a 
group must have the same value in a 
specified field. 

header: Constant text formatted to 
be in the top margin of one or more 
pages . 

highlight: The process of 
emphasizing an area on the display by 
brightening the area and reversing 
the color of any characters within 
the area. 

include instruction: An instruction 
used in a text field to retrieve and 
print text typed in a text document 
when the field is printed. 

index: On a diskette, a list of 
document names and comments . A 
diskette index can be viewed or 
printed. 

licensed program: Software program 
which remains the property of the 
manufacturer, for which customers 
pay a license fee. 

key fFeld: In a file containing both 
complete and partial records, it is a 


field used in both types of records 
to link them during output. 

math field: A type of field that can 
contain only numbers , a decimal 
point, and a plus or minus sign. 

math instruction: A type of 
instruction used to peform math 
calculations during output. 

maximum field length: The 

system-defined limit on the number of 
character that can be typed into each 
field type. 

menu: Choices listed on the display 
that can be selected by an operator. 

merge file/report: The ability to 
combine fields from all selected 
output records with a shell document 
to produce one output document. 

merge file/text: The ability to 
merge file information into a shell 
document; may be either merge 
file/report or merge record/text. 

merge record/text: The ability to 
combine fields from a single record 
with a shell document to produce one 
output document per record. 

message: A message issued by the 
system because of a condition that 
requires an operator response. 

pagination: The process of adjusting 
text to fit within margins and/or 
page boundaries. 

prompt: Information that appears on 
the display to alert the operator to 
a specific condition or action 
needed. 

record: A collection of related 
data or words , that make up one entry 
in a file. For example, a record can 
contain all the information about one 
person, one project, or one 
department . 
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repetitive letter: A personalized 
form letter created by merging a 
record with a shell document. When 
the shell document is merged with the 
file, one letter is produced for each 
selected record. 

report: A type of file output that 
compiles information from all 
selected records into one final 
document. It is created by merging a 
file with a shell document. 

revision: The process of changing 
the text and/or format of a document. 

running total: Use of an answer 
variable to compile the total of the 
answers to a math calculation 
performed on a series of records. 

scale line: A line on the display 
showing margins, tabs, and character 
positions . 

segment: To move the display image 
horizontally to bring into view 
information that is to the left or 
right of the display's boundaries. 

select: The ability to choose only 
certain records based on field 
values . 


shell document: A standardized 
document containing codes that allow 
file information to be merged with 
the shell to produce final documents. 

sort: The ability to arrange records 
sequentially according to field 
values . 

source file: During the duplication 
of a file, it is the file that the 
records are being copied from. 

subtitle: A secondary or explanatory 
title that follows a name, such as 
Jr. or III. 

text field: A type of field that can 
contain alphabetic and numeric 
characters, as well as formatting 
control characters. 

title: A descriptive name that 
precedes a persons 's name, such as 
Mr. or Miss . 

variable: Information (such as name, 
date, time) that can be inserted 
within a standardized document. 
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adding records 

from another file 4-7 
from computer 4-5 
from text 4-5 
typed 4-5 

address fields 3-8 

alphabetic characters 
use in fields 4-4 
with numbers 3-11 

AND 6-3 

answer variable 8-1 


dates 

printing fields 3-8 

sorting 

by month, day 3-9 
by year, month, day 3-8 
delete 4-9 
design check 14-1 
detail (record) 

defined 11-1 

used 11-22 
duplicating records 

to an existing file 4-7 

to a new file 4-7 


calculation sign 8-2 
chapter exercises (how to use) 
character field 2-13 
character sort chart B-1 
column 

single set of 13-1 

multiple sets of 13-3 
column width 13-6 
combined fields 3-13 
comment begin characters C-2 
comparison criteria 6-2 
complete records 3-14 
conditional text 

defined 5-7 

in repetitive text 10-2 

in reports 13-1 
constant number 8-2 
conversion of 

named variable list C-3 

switch code list C-4 

text tables C-6 
conversion rules C-1 
count 4-9 


1-2 


field (defined) 2-1 
field name 2-11 
field order 4-3 
field type 

defined 2-12 

character 2-13 

math 2-13 

revising 2-15 

text 2-14 
field separator C-1 
file 

defined 2-1 

maximum size 2-10 
file description 4-1 
File Design Worksheet 
file output 

defined 2-3 

types 

with merge 5-4 
without merge 5-1 
file setups 9-5 
first number 8-1 
forms 2-10 
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M 


group definition (see record group 

definition) 
group summary (see record group 

summary) 


information management 3-1 
ignore character 6-8 
ignore rest (of field) 6-9 
instruction sign 5-5 


math calculation 

more than one 8-3 

placement in a shell 8-6 

single 8-1 
math field type 2-13 
math formats 9-1 
Math Formats Worksheet 9-1 
math instructions 8-1 
Math Instructions Worksheet 
maximum field length 

character field 2-13 

defined 2-12 
math 2-13 
revising 2-15 
text 2-14 
multi-column list 2-8 
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K 


N 


key field 3-15 

keyword field (see combined field) 


name fields 3-6 

named variable list C-3 

numbers 

use in fields 2-13 

with alphabetic characters 
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list 

multi-column 
defined 2-8 
used 13-3 
single column 
logical criteria 


13-1 
6-3 


OR 6-3 

output sample documents 
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page heading 
defined 11-1 
used 11-14 

partial records 

preface 

defined 11-1 
used 11-18 
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3-14 


record (defined) 2-1 
record detail 
defined 11-1 
used 11-22 
record group definition 
defined 11-1 
used 11-6 
record group summary 
defined 11-1 
used 11-14 
Record ID 4-3 

Record Selection Specifications 16-1 
record separator C-1 
repetitive letters 
defined 2-3 
used 10-1 
report 

building one 11-4 
defined 2-6 

look like letters 12-1 
more than one group 11-26 
parts 

page heading 11-1, 11-14 
record detail 11-1, 11-22 
record group definition 

11-1, 11-6 
record group summary 11-1, 11-7 
report preface 11-1, 11-18 
report summary 11-1, 11-14 
Report Design Worksheet 11-4 
revising field type and length 2-16 
running total 8-8 
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second number 8-1 
select 

defined 2-1 

used 6-1 
Selection Specifications 

setups 9-5 

shell document 
defined 2-3 
creating 5-5 
list 13-1 

repetitive letter 10-1 
report 11-1 
sort 

defined 2-3 

used 7-1 
Sort Specifications 
stored file setups 
subtitle field 3-7 
summary 

record group 11-1, 11-7 

report 11-14 
summary math instructions 11-7 
Summary Math Instructions Worksheet 

11-7 
switch code lists C-5 


7-1 
9-5 


text 2-14 
text tables C-6 
title field 3-7 
typed records 4-4 
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variable name for answered 8-1 
variable sign 5-5 
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Worksheets 

File Design 3-2, A-2 

how to use 1-2 

Math Formats 9-2, A-3 


Math Instructions 8-2, A-4 
Multi-column File List 13-3, A-5 
Record Selection Specifications 

6-1, A-7 
Report Design 11-4, A-6 
Sort Specifications 7-1, A-7 
Summary Math Instructions 11-10, A-4 
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